Please wait...
This module is used for integrating Mobile Money with Merchants systems to enable real time payments to Customers. This webservice enables money transfer from a business account to an airtel mobile number.
In order for Merchant to use this service the following need to be in place.
The API request is made via HTTP POST to
https://api.dibon.co.ke
All parameters below are compulsory. The parameters are:
Generic Api Request
Parameter | Description | Example |
---|---|---|
api_key | This should match the api key that you have generated for your Dibon account here | 2_aa67677e8bf1d4c8fe886a38c03a860 |
client_id | This should match the id of your account; found on your dashboard | 2 |
command_id | Pass this as am_b2c | am_b2c |
business_shortcode | The organization shortcode | 12345 |
amount | Amount to be paid | 70000 |
description | The message intended for the recipient MSISDN | Do you want to pay 70000 to Dibon Company Ltd |
Parameter | Description | Example |
---|---|---|
status_code | Transaction Response code | 200 |
descritpion | Response description | Success. Request Scheduled Successfully |
request_id | The unique referrence number as assigned by Dibon API | Dibon20180307054639H4adfKDJDKQ7H |
phone_number | Recipient MSISDN | 254789970265 |
amount | Amount to be paid by Recipient | 70000 |
Note that in order to ensure that you do not miss any transaction notifications the instant they come onto our api, register a callback url that we will invoke whenever we receive a notification for your service.
This is done on your Dibon Account Airtel Money Call Back Section.
Every time a transaction status changes, we will forward you the following information as POST variables as outlined below as a JSON object.
Parameter | Description | Example |
---|---|---|
request_id | The unique reference number as assigned by the Dibon API | Dibon20180307054639H4adfKDJDKQ7H |
transaction_time | The date and time stamp of the transaction. | 2020-11-19 11:12:23 |
result_desc | A string with transaction details | 245070155286 confirmed. You have deposited Ksh 115 to John Doe 0789970265 on 19/11/20 at 11:12 AM. New float balance is Ksh 9,400. Get 10% bonus airtime when you top up with 50 bob or more using Airtel Money |
amount | The amount for that particular transaction | 70000 |
phone_number | Recipient of the payment | 254789970265 |
{ "api_key":"2_aa67677e8bf1d4c8fe886a38c03a86020180302111157", "client_id":"2", "command_id":"am_b2c", "business_shortcode":"12345", "phone_number":"254789970265", "amount":"70000", "description":"Do you want to pay 70000 to Dibon Company Ltd" }
{ "status_code": 200, "description": "Success. Request Scheduled Successfully", "request_id": "Dibon202011041210483957kKZCWRorc", "phone_number": "254789970265", "amount": "70000", "business_shortcode": "12345"
{ "amount": "70000", "result_desc": "245070155286 confirmed. You have deposited Ksh 115 to John Doe 0789970265 on 19/11/20 at 11:12 AM. New float balance is Ksh 9,400. Get 10% bonus airtime when you top up with 50 bob or more using Airtel Money", "result_code":"200", "transaction_time": "2020-11-19 11:12:23", "phone_number": "254789970265", "request_id": "Dibon202011041210483957kKZCWRorc" }