post https://api-v3-uat.tanda.africa/io/v3/organizations//consumers//request/b2cbank
Initiates a bank Withdrawal from a consumer's wallet.
Consumer Bank Withdrawal API
Consumer Bank Account Withdrawal
This API allows consumers to withdraw money from a merchant's account to a bank account via Pesalink, authorized similarly via standard verification prompts.
Request Body Parameters
| Parameter | Description | Mandatory |
|---|---|---|
| commandId | Command to execute, must be ConsumerBankWithdrawal | Yes |
| serviceProviderId | Payment service provider, e.g., PESALINK | Yes |
| reference | Unique identifier for the transaction (UUID or alphanumeric) | Yes |
| request | Array of key-value pairs specifying withdrawal details | Yes |
Request Details in request Array for Bank Withdrawal
request Array for Bank Withdrawal| id | Description | Mandatory |
|---|---|---|
| amount | Amount to be withdrawn in Ksh | Yes |
| narration | Description or note for the payment | Yes |
| accountNumber | Bank account number to receive funds | Yes |
| bankCode | Bank's unique code (e.g., 40401000) | Yes |
| accountName | Name of the bank account holder | Yes |
| ipnUrl | URL to receive instant payment notifications | Yes |
Example Request - Bank Withdrawal
{
"commandId": "ConsumerBankWithdrawal",
"serviceProviderId": "PESALINK",
"reference": "e9b1c7d8-f7e9-4fda-99ed-31e8370aa9b4",
"request": [
{
"id": "amount",
"value": "10",
"label": "Amount"
},
{
"id": "narration",
"value": "Payment",
"label": "Narration"
},
{
"id": "accountNumber",
"value": "01236678990",
"label": "Account Number"
},
{
"id": "bankCode",
"value": "40401000",
"label": "Bank code"
},
{
"id": "accountName",
"value": "John Doe",
"label": "Account name"
},
{
"id": "ipnUrl",
"value": "https://tanda-tills-ipn.free.beeceptor.com",
"label": "Notification URL"
}
]
}Sample Response - Bank Withdrawal
{
"trackingId": "a17f35d2-9b21-4c0b-99fd-b067d4b7b22f",
"reference": "e9b1c7d8-f7e9-4fda-99ed-31e8370aa9b4",
"status": "P202000",
"message": "Successful. Request accepted for processing. You'll be notified by Tanda shortly"
}