TZS Payout(new encryption)
Summary
These APIs are used to initiate a TZS payout
Integration steps
Token GenerationMerchant Payout request
Make a POST call to the Merchant payout request API
POST
{{env_url}}/wallet/merchant/bank/transfer/request/v2
You would need to pass, as a header the x-auth-token. This can be obtained from your merchant dashboard → Settings → Generate API keys → Merchant public key.
Headers
Content-Type
application/json
x-auth-token
Your merchant public key
Authorization
Bearer <token here>
Request body (encrypted):
{
"message": "encrypted-request-body"
}
Request body (plain)
Request Body
country*
Country of payout - TZ
serviceCode*
Allowed Payout types:
Bank: TZ-BANK-B2C
Mobile Money: TZ-TIGO-B2C or TZ-Airtime-B2C
amount*
Amount - 1000
accountName*
Receiver's Name - John Doe
requestId*
String
Unique request's reference - TZS-payout-3
description*
String
Merchant's description - Payout
currency*
String
Currency of payout - TZS
accountNumber*
String
Receiver's account number - 255713998877
{
"country": "TZ",
"serviceCode": "TZ-TIGO-B2C",
"amount": 1000,
"accountName": "John Doe",
"accountNumber": "255713998877",
"currency": "TZS",
"requestId": "TZS-payout-3",
"description": "Payout",
}
{
"id": 694,
"amount": 1000.00,
"payoutStatus": "PENDING",
"requestId": "TZS-payout-3",
"narration": "Payout",
"country": "TZ",
"fee": 826.00,
"bankCode": "TZ-TIGO-B2C",
"bankName": "TZ-TIGO-B2C",
"accountNumber": "255713998877",
"accountName": "John Doe"
}
Query payout status
Make a call to fetch status of initiated payouts.
Last updated