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

Please wait...

Airtel Money B2C


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.

Prerequisites

In order for Merchant to use this service the following need to be in place.

  1. The Merchants must be registered in Mobile Money.
  2. The Merchant must be registered to use this service.
  3. The Merchant will be provided with the following details
    1. Client ID
    2. API Key
    3. The Merchant Query Web service url
  4. The merchant need to develop a web service client to consume this web service.
  5. The merchant need set up the wallet details for the pabill here
Integration

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

Generic API Response
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

Generic API Result

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


Sample Request
                            {
                              "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"
                            }

                            


Sample Response
                            {
                              "status_code": 200,
                              "description": "Success. Request Scheduled Successfully",
                              "request_id": "Dibon202011041210483957kKZCWRorc",
                              "phone_number": "254789970265",
                              "amount": "70000",
                              "business_shortcode": "12345"
                          


Sample Result
                          {
                            "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",
                            "transaction_time": "2020-11-19 11:12:23",
                            "phone_number": "254789970265",
                            "request_id": "Dibon202011041210483957kKZCWRorc"
                          }