Merchant to Merchant Transfer

This is an On-Net/Internal transfer. It moves money from a Merchant float wallet to another.

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

Method: POST

CommandId: MerchantToMerchantTandaPayment

Use the following for testing

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

partyA: 746312

partyB: 340044

Body

Parameter	Description	Mandatory
commandId	Specifies the command used to resolve a payment option, in this case, MerchantToMerchantTandaPayment	Yes
serviceProviderId	Specifies the service provider for on-net/internal payment, Supported service providers are:
- TANDA	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
partyA	Uniquely identifies an entity making a request. This is issued by Tanda	Yes
partyB	Uniquely identifies an entity recieving payment. This is issued by Tanda	Yes
narration	Description of the payment.	Yes
ipnUrl	URL to recieve Instant payment notifications on.	Yes

Example

{
  "commandId": "MerchantToMerchantTandaPayment",
  "serviceProviderId": "TANDA",
  "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": "43210",
        "label": "Short code"
    }
  ]
}

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