Airtime API, SMS API, Payment API (pesalink, airtel and Mpesa b2c, b2b, stk-push)

Please wait...

Airtel Money C2B


Customer to business enables Merchant's clients to make payment to merchant's paybill. A merchant will get a notification of payment everytime a customer makes a payment.

Prerequisites

To receive notification of payment:

  1. The Merchants must be registered in Airtel Money.
  2. The Merchant must register here to use this service.
  3. The Merchant must set a callback
  4. A mercahnt is advised to set validation URL to validate payments made by clients and respond with:
    1. SUCCESS for a valid transaction or
    2. FAILED for an invalid transaction.
  5. The merchant need to develop a web service client to consume this web service.
Notification

The merchant will recieve notification through the validation URL set. Please note that your transaction will not be processed if Dibon does not get a response from merchants who have set a validation URL.

Notification Parameters are:
Parameter Description Example
request_id Unique transaction ID 2_aa67677e8bf1d4c8fe886a38c03a860
amount Amount paid by customer to paybill 1000
transaction_time The time when transaction was made 2020-12-08 18:30:43
account Merchants wallet number 000009580
phone_number The phone number of the customer making the transaction 0789970265
name The name of customer who is making the transaction John Doe
Generic API Response
Parameter Description Example
request_id A string with unique transaction ID 2_aa67677e8bf1d4c8fe886a38c03a860
amount Amount paid by customer to paybill 1000
phone_number The phone number of the customer making the transaction 0789970265
transaction_time The date and time when transaction was made 2020-12-08 18:30:43
result_desc A string with transaction details Success


Sample Notification 
                  {                   
                    "request_id": "Dibon202011041210483957kKZCWRorc"
                    "amount":"1000", 
                    "transaction_time": "2020-10-28 17:20:50.0",
                    "phone_number":"254789970265",
                    "account":"000009580"
                  }


Sample Result 
                {
                  "amount": "1000",
                  "result_desc": "Success",
                  "result_code":"0",
                  "transaction_time": "2020-10-28 17:20:50.0",
                  "phone_number": "254789970265",
                  "request_id": "Dibon202011041210483957kKZCWRorc"
                }