Skip to main content
An Order BillPay Control Number is a dynamic number for a single transaction or invoice. It is ideal for one-time payments such as e-commerce orders, invoices, or single service charges.
New integrations should use the BillPay API to create order control numbers.
When using the BillPay API, you get full control over the control number. You can directly set the custom reference, which becomes the actual control number customers will use to pay. This means the number does not need to follow the offline concatenation format.
You can use your own references that already exist in your system (for example invoice, loan IDs or order IDs) as billReference. The value must be unique within ClickPesa for your account.
With API generation, you can also:
  • Set the amount to be paid (optional).
  • Control payment mode:
    • Require full payment only.
    • Allow partial payments.
    • Allow overs.
  • Set a max total that can be collected (optional). Caps how much this number can take; useful if you allow overs. Order numbers still accept only one payment.
  • Add a bill description.
  • Set a custom reference (actual customer-facing control number).
Example use case: A SaaS platform generates an Order BillPay Control Number via API with a fixed amount, partial payment allowed, and a meaningful control number like INV2025001.

​
Legacy: Manual Concatenation

Legacy mode. Available only when enabled for your account by ClickPesa. Contact support or your account manager to request enablement.
Structure: [Merchant BillPay-Namba] + [Order Reference]
  • Merchant BillPay-Namba — your 4-digit merchant number assigned by ClickPesa.
  • Order Reference — any unique reference from your internal billing or order system.
Example: Merchant BillPay-Namba: 1122 Order Reference: 231256 Order BillPay Control Number: 1122231256
This method does not require API calls. It is intended for merchants with existing offline billing systems who collect payments by combining their BillPay-Namba with an internal order reference.

​
Making Payments with Order BillPay Control Numbers

Customers can pay via:
  • Mobile Money: Mixx By Yas, Airtel Money, Halopesa, M-Pesa
  • CRDB Banking: SIM Banking (APP/USSD), Internet Banking, CRDB Wakalas

​
via Airtel Money

  1. Piga *150*60#
  2. Chagua Chaguo 5 --- Lipia Bili
  3. Chagua Chaguo 2 --- Chagua Kampuni
  4. Chagua Chaguo 7 --- Chagua Kampuni
  5. Weka Namba --- 47
  6. Ingiza namba ya Kumbukumbu --- []
  7. Weka Kiasi
  8. Chagua 1 --- (Ndio) Kuthibitisha
  9. Weka PIN

​
via M-Pesa

  1. Piga *150*00#
  2. Chagua Chaguo 4 --- Lipia Kwa M-Pesa
  3. Chagua Chaguo 4 --- Weka Namba ya Kampuni
  4. Ingiza Namba ya Kampuni --- [M-Pesa Merchant Number] - Available at onboarding
  5. Weka namba ya Kumbukumbu ya Malipo --- []
  6. Weka Kiasi
  7. Weka Namba ya Siri
  8. Bonyeza 1 Kuthibitisha

​
via Mixx By Yas

  1. Piga *150*01#
  2. Chagua Chaguo 4 --- Lipia Bili
  3. Chagua Chaguo 3 --- Ingiza Namba ya Kampuni
  4. Ingiza Namba ya Kampuni --- 889999
  5. Weka Kumbukumbu ya Malipo --- []
  6. Ingiza Kiasi
  7. Ingiza Namba ya Siri

​
via Halopesa

  1. Piga *150*88#
  2. Chagua Chaguo 4 --- Lipia Bili
  3. Chagua Chaguo 3 --- Ingiza Namba ya Kampuni
  4. Ingiza Namba ya Kampuni --- 889999
  5. Weka Kumbukumbu ya Malipo --- []
  6. Ingiza Kiasi
  7. Ingiza Namba ya Siri
  8. Chagua 1 --- (Ndio) Kuthibitisha

​
via CRDB

  1. Piga *150*03#
  2. Chagua 1 --- Simbanking
  3. Weka Namba ya Siri
  4. Chagua 4 --- Pay Bills
  5. Chagua 6--- Taasisi
  6. Chagua 7 --- Nyinginezo
  7. Chagua N –— Next
  8. Chagua N –— Next
  9. Chagua CLICKPESA
  10. Weka Namba ya Malipo --- []
  11. Ingiza Kiasi
  12. Thibitisha Malipo

​
Payment Tracking