> ## Documentation Index
> Fetch the complete documentation index at: https://docs.clickpesa.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Order BillPay Control Number

> A one-time payment number for a specific transaction or invoice — created via API or, for legacy accounts, by manual concatenation.

export const operation_0 = "Pay"

export const controlNumber_0 = "Order BillPay Control Number"

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.

<Tip>
  New integrations should use the **BillPay API** to create order control numbers.
</Tip>

## Via API (Recommended)

When using the [BillPay API](/api-reference/collection/billpay/create-order-control-number), 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`.

<h2 id="legacy-manual-concatenation">
  Legacy: Manual Concatenation
</h2>

<Warning>
  Legacy mode. Available only when enabled for your account by ClickPesa.
  Contact support or your account manager to request enablement.
</Warning>

**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

<Tip>
  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.
</Tip>

## 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

### [{operation_0} via Airtel Money](#pay-via-airtel-money)

<Tabs>
  <Tab title="Airtel Money USSD">
    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 --- **\[{controlNumber_0}]**
    7. Weka Kiasi
    8. Chagua `1` --- **(Ndio) Kuthibitisha**
    9. Weka PIN
  </Tab>

  <Tab title="Airtel Money APP">
    1. Fungua AirtelMoney App
    2. Bonyeza **Lipa Bili**
    3. Bonyeza **Ingiza jina la biashara au namba**
    4. Andika *"clickpesa"*
    5. Chagua **CLICKPESA TANZANIA**
    6. Weka Kumbukumbu ya Malipo --- **\[{controlNumber_0}]**
    7. Weka Kiasi
    8. Bonyeza **Endelea**
    9. Weka Namba ya Siri
  </Tab>
</Tabs>

### [{operation_0} via M-Pesa](#pay-via-m-pesa)

<Tabs>
  <Tab title="M-Pesa USSD">
    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 --- **\[{controlNumber_0}]**
    6. Weka Kiasi
    7. Weka Namba ya Siri
    8. Bonyeza 1 Kuthibitisha
  </Tab>

  <Tab title="M-Pesa App">
    1. Fungua M-Pesa App
    2. Bonyeza **Lipia kwa M-Pesa**
    3. Bonyeza **Kitambulisho cha biashara** na Weka **\[M-Pesa Merchant Number]**
    4. Bonyeza **Kumbukumbu** na Weka **\[{controlNumber_0}]**
    5. Weka Kiasi
    6. Bonyeza **Endelea**
    7. Bonyeza **Lipa sasa** na Ingiza Namba ya Siri
  </Tab>
</Tabs>

### [{operation_0} via Mixx by Yas (Tigopesa/Zantel)](#pay-via-mixx-by-yas-tigopesa%2Fzantel)

<Tabs>
  <Tab title="Mixx USSD">
    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 --- **\[{controlNumber_0}]**
    6. Ingiza Kiasi
    7. Ingiza Namba ya Siri
  </Tab>

  <Tab title="Mixx By Yas APP">
    1. Fungua Mixx By Yas App
    2. Bonyeza **Kulipa Bili**
    3. Andika *"clickpesa"* Kwenye **Tafuta**
    4. Chagua **ClickPesa-889999** Kwenye listi
    5. Weka Namba ya kumbukumbu --- **\[{controlNumber_0}]**
    6. Weka kiasi
    7. Bonyeza **Endelea**
    8. Ingiza Namba ya Siri ya Mixx
    9. Bonyeza **Thibitisha**
  </Tab>
</Tabs>

### [{operation_0} via Halopesa](#pay-via-halopesa)

<Tabs>
  <Tab title="Halopesa USSD">
    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 --- **\[{controlNumber_0}]**
    6. Ingiza Kiasi
    7. Ingiza Namba ya Siri
    8. Chagua `1` --- **(Ndio) Kuthibitisha**
  </Tab>

  <Tab title="Halopesa APP">
    1. Fungua Halopesa App
    2. Bonyeza **Lipia Bili**
    3. Bonyeza **Chagua Namba ya biashara**
    4. Andika *"889999"* Kwenye uwanja wa kutafuta **Namba ya biashara**
    5. Bonyeza **ENDELEA**
    6. Weka kumbukumbu namba --- **\[{controlNumber_0}]**
    7. Weka kiasi
    8. Bonyeza **ENDELEA**
    9. Ingiza Namba ya Siri
    10. Ingiza OTP
  </Tab>
</Tabs>

### [{operation_0} via CRDB](#pay-via-crdb)

<Tabs>
  <Tab title="SimBanking USSD">
    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 --- **\[{controlNumber_0}]**
    11. Ingiza Kiasi
    12. Thibitisha Malipo
  </Tab>

  <Tab title="SimBanking APP">
    1. Fungua CRDB SimBanking App
    2. Weka Namba ya Siri ya SimBanking
    3. **Pandisha kupata huduma zaidi**
    4. Bonyeza **Malipo Zaidi**
    5. Chagua **CLICKPESA** Kwenye listi au andika **CLICKPESA** Juu Kwenye Tafuta huduma
    6. Weka Namba ya Malipo --- **\[{controlNumber_0}]**
    7. Bonyeza **PATA TAARIFA**
    8. Hakikisha Taarifa za Bili, Chagua Akaunti Ya Kutoa na Weka Kiasi
    9. Bonyeza **ENDELEA**
    10. Hakikisha Taarifa za Muamala na Bonyeza **THIBITISHA**
  </Tab>

  <Tab title="CRDB Internet Banking">
    1. Login into your CRDB Internet Banking portal
    2. Select **Payment**
    3. Select **Bill Payment**
    4. Company Category --- Select **Others**
    5. Company Name -- Select **CLICKPESA**
    6. Enter Reference Number --- **\[{controlNumber_0}]**
  </Tab>

  <Tab title="CRDB Wakala (App/POS)">
    1. Tembelea wakala CRDB aliye karibu nawe
    2. Omba kulipia bili kwa namba ya malipo ya CRDB
    3. Toa jina la taasisi --- **CLICKPESA**
    4. Toa namba ya nmaba ya malipo --- **\[{controlNumber_0}]**
    5. Toa kiasi
  </Tab>

  <Tab title="CRDB Branch (OTC)">
    1. Tembelea tawi la CRDB lililo karibu nawe
    2. Omba kulipia bili kwa namba ya malipo ya CRDB
    3. Toa jina la taasisi --- **CLICKPESA**
    4. Toa namba ya nmaba ya malipo --- **\[{controlNumber_0}]**
    5. Toa kiasi
  </Tab>
</Tabs>

## Payment Tracking

* **Automatic Notifications:** Receive instant updates via [Webhooks](/home/webhooks).
* **Manual Check:** Use the [Payment Query API](/api-reference/collection/querying-for-payments/querying-for-payments).