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. You can generate an Order BillPay Control Number in two ways — each with different flexibility and structure.

​
1. Offline / Manual Concatenation

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 is quick and does not require any API calls. It’s useful when you already have an offline billing system but want to instantly collect payments online using ClickPesa.

​
2. Via API

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. With API generation, you can also:
  • Set the amount to be paid.
  • Control payment mode:
    • Require full payment only.
    • Allow partial payments.
    • Allow overs.
  • 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.

​
Making Payments with Order BillPay Control Numbers

Customers can pay via:
  • Mobile Money: Tigopesa, 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*01#
  2. Chagua Chaguo 4 --- Lipia Bili
  3. Chagua Chaguo 3 --- Ingiza Namba ya Kampuni
  4. Ingiza Namba ya Kampuni --- [M-Pesa Merchant Number] - Available at onboarding
  5. Weka Kumbukumbu ya Malipo --- []
  6. Ingiza Kiasi
  7. Ingiza Namba ya Siri

​
via Mixx by Yas (Tigopesa/Zantel)

  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