Business Pay Bill

4. Businesss to Business Via Mobile Money Paybill

This option is for sending money to an M-pesa Paybill from a Merchant float wallet.

Path: /io/v3/organizations/{organizationId}/request

Method: POST

CommandId: MerchantTo3rdPartyBusinessPayment

Use the following for testing

organizationId: a353acfa-5340-49ac-8f7c-2f807a87fc2f

shortCode: 746312

Body

Parameter	Description	Mandatory
commandId	Specifies the command used to resolve a payment option, in this case, MerchantTo3rdPartyBusinessPayment	Yes
serviceProviderId	Specifies the service provider for the mobile money payment, Supported service providers are: MPESA	Yes
reference	A unique reference for the transaction. It should be between 8-16 alphanumeric characters.	Yes
request	Object array containing additional request details	Yes

Request parameters

Parameter	Description	Mandatory
amount	The amount of money in Ksh.	Yes
shortCode	Uniquely identifies an entity making a request. This is issued by Tanda	Yes
businessNumber	M-pesa pay bill business number	Yes
accountReference	M-pesa pay bill account number
It should be a set of alphanumeric characters.	Yes
narration	Description of the payment.	Yes
ipnUrl	URL to receive Instant payment notifications on.	Yes

Example

{
  "commandId": "MerchantTo3rdPartyBusinessPayment",
  "serviceProviderId": "MPESA",
  "reference":"REFEBC1234",
  "request": [
    {
        "id": "amount",
        "value": "100",
        "label": "Amount"
    },{
        "id": "narration",
        "value": "Payment via Till",
        "label": "Narration"
    },
    {
        "id": "ipnUrl",
        "value": "https://tanda-tills-ipn.free.beeceptor.com/results",
        "label": "Notification URL"
    },{
         "id": "shortCode",
        "value": "225611",
        "label": "Short code"
    },{
         "id": "businessNumber",
        "value": "522522",
        "label": "Business number"
    },{
         "id": "accountReference",
        "value": "1173677844",
        "label": "Account reference"
    }
  ]
}

Sample response

{
    "trackingId": "b5b47bd2-c1da-4b8a-b0de-ffb4ec474bff",
    "reference": "QBQIGRH1",
    "status": "P202000",
    "message": "Successful. Request accepted for processing. You'll be notified by Tanda shortly"
}