BankTransfer

This endpoint allows you to submit a BankTransfer payout in Tanzania.

Before submitting a payout, use the Bank Account List API to retrieve the supported bank_code values.

POST https://sandbox.transfersmile.com/api/payout

Request Body

Parameter	Type	Required	Constraints	Description
name	string	Required	Beneficiary's full name. Length: 5–100 characters.	Beneficiary name.
bank_code	string	Required	Use a supported Tanzania bank_code returned by the Bank Account List API	Beneficiary bank code.
account	string	Required	Max length: 20	Beneficiary bank account number.
fee_bear	string	Required	All fees charge to merchant or beneficiary. - One of: merchant, beneficiary -	Indicates who bears the payout fee.
amount	string	Required	1000~5000000	Payout amount.
source_currency	string	Required	One of：USD, EUR, GBP,TZS	Merchant account currency.
arrival_currency	string	Required	Fixed value: TZS	Currency received by the beneficiary.
notify_url	string	Required	Valid URL	The URL to receive payout notifications.
custom_code	string	Required	Max length: 64	Merchant payout order number. Must be unique.
additional_remark	string	Required	Max length: 255	Additional payout remark.
country	string	Required	Fixed value: TZA	Destination country.
method	string	Required	Fixed value: BANKTRANSFER	Payout method.
phone	string	Required	Beneficiary's phone - Max 15, valid phone -	Beneficiary phone number.

Request Sample

{
  "name": "Ro********be",
  "bank_code": "920",
  "account": "01********00",
  "fee_bear": "merchant",
  "amount": "1000",
  "source_currency": "USD",
  "arrival_currency": "TZS",
  "notify_url": "https://sandbox.transfersmile.com/api/notify/demo",
  "custom_code": "custom_code31********",
  "additional_remark": "banktransfer payout request",
  "country": "TZA",
  "method": "BANKTRANSFER",
  "phone" : "25********50"
}

Response Sample

{
  "code": 200,
  "msg": "success",
  "time": 1785825006,
  "data": {
    "id": "TS2026********",
    "custom_code": "custom_code31********",
    "arrival_amount": "1000",
    "arrival_currency": "TZS",
    "source_amount": "0.39",
    "source_currency": "USD",
    "status": "IN_PROCESSING"
  }
}

Query Bank Code

Use the Bank Account List API to retrieve the supported bank_code values for Tanzania BankTransfer payouts.

POST https://sandbox.transfersmile.com/api/payout/bank-account-list

Request Sample

{
  "timestamp": "1785209231",
  "method": "BANKTRANSFER",
  "country": "TZA"
}

Error Codes

For more information about payout error codes, please refer to Payout API Code.