Mobile Money Payment API
The Mobile Money Payment API enables you to collect payments directly from customers’ mobile money wallets using USSD-PUSH requests
Prerequisites
-
API Keys - Create an Application to generate Client ID and API Keys for API acces
-
Authorization Token - Use API Keys to Generate Authorization Token
How It Works
Step 1 - Validate push request details
Preview USSD-PUSH Request
This endpoint validates payment details like Mobile Number, Amount, Order Reference and verifies Payment Methods availability
Step 2 - Send push request
Initiate USSD-PUSH Request
This endpoint sends the USSD-PUSH request to customer’s mobile device. The customer will be prompted to enter their mobile money wallet PIN/password to complete the transaction
Step 3 - Check payment status
Check Payment Status
This endpoint queries for the payment status using payment’s Order Reference
Notes
BillPay Control Numbers
There’s no API to create an BillPay Control Numbers. You generate it by combining your Merchant BillPay-Namba with an reference. This full order number is shared with the customer as the payment reference. Once paid, ClickPesa routes the payment using the BillPay-Namba and sends a webhook with the full control number and payment details.