Business Buy Goods

3. Business to Business Via Mobile Money Till

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

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

Method: POST

CommandId: MerchantTo3rdPartyMerchantPayment

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, MerchantTo3rdPartyMerchantPayment	Yes
serviceProviderId	Specifies the service provider for the mobile money payment, Supported service providers are: MPESA	Yes
reference	A unique reference for the transaction.	Yes
request	Object array containing additional request details	Yes

Request parameters

Parameter	Description	Mandatory
amount	The amount of money in Ksh.	Yes
partyA	Uniquely identifies an entity making a request. This is issued by Tanda	Yes
partyB	A valid M-Pesa till	Yes
narration	Description of the payment.	Yes
ipnUrl	URL to receive Instant payment notifications on.	Yes

Example

{
  "commandId": "MerchantTo3rdPartyMerchantPayment",
  "serviceProviderId": "MPESA",
  "reference":"REFEBC1234",
  "request": [
    {
        "id": "amount",
        "value": "2",
        "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": "partyA",
        "value": "01234",
        "label": "Short code"
    },{
         "id": "partyB",
        "value": "000000",
        "label": "Till"
    }
  ]
}

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"
}