Where can I find the endpoint to create an Order BillPay Control Number? A: There is no API endpoint to create an Order BillPay Control Number. Instead, you create it on your side by combining your Merchant BillPay-Namba (assigned by ClickPesa) with a unique order reference from your system. This combined value is what you share with the customer as the payment reference. When a customer makes a payment using that BillPay number, ClickPesa uses the BillPay-Namba to route the payment to your account and sends you a webhook notification containing the full BillPay number and payment details.
If a client is given a control number for 1,000,000/= but pays only 500,000/=, will the payment go through? A: Yes. Partial payments are accepted, and you’ll be notified of the amount received via webhook, email and web notfications.
Can the same control number be used to pay the remaining balance later? A: It depends on the type of BillPay control number:
  • Order BillPay Control Number - No
    • Meant for one-time, specific transactions.
    • Cannot be reused—once paid (even partially), it’s closed or marked fulfilled.
  • Customer BillPay Control Number - Yes
    • Designed for ongoing or repeat payments from the same customer.
    • Can receive multiple payments, making it suitable for partial or recurring payments.