Pay to Other Banks

Use this endpoint to transfer funds from a wallet to other banks. All local banks are supported.

Wallet to Other Banks

POST https://sandbox.temboplus.com/tembo/v1/payment/bank

This endpoint facilitates the transfer of funds from either a customer wallet or a disbursement wallet to a local bank account. Only local banks are supported; international bank accounts are not eligible for transfers. It is important to note that only customer wallets and disbursement wallets are eligible for this type of transaction. Fund transfers cannot be initiated from a collection wallet.

If you need to retrieve the account number for your disbursement wallet, you can make use of the "Main Balance" endpoint. This endpoint will provide you with your main (disbursement) account number.

Headers

NameTypeDescription

x-account-id*

string

Partner account id

x-secret-key*

string

Partner secret key

x-request-id*

string

A unique id identifying this request

Request Body

NameTypeDescription

countryCode*

string

Country code. Currently, the only supported value is TZ

accountNo*

string

The account number of the wallet from which you intend to transfer funds. This can be either a customer wallet or your main (disbursement) wallet.

serviceCode*

string

Should be set to TZ-BANK-B2C for bank payouts

amount*

number

Amount to be transferred

msisdn*

string

BIC and account number of the payee in the format <BIC>:<ACCOUNT NUMBER>. Example CORUTZTZ:0150089776444

narration*

string

Narration for this transfer

currencyCode*

string

Currency code. Currently only TZS is supported

recipientNames*

string

First and last names of the recipient

transactionRef*

string

Your system reference that should be associated with this transaction

transactionDate*

string

The value date of the transaction

callbackUrl*

string

The web hook callback URL to be called with the current transaction update

{
  "statusCode": "PENDING_ACK",
  "transactionRef": "20f807fe-3ee8-4525-8aff-ccb95de38250",
  "transactionId": "X50jcLD-U"
}
curl --request POST \
  --url https://sandbox.temboplus.com/tembo/v1/payment/bank \
  --header 'content-type: application/json' \
  --header 'x-account-id: ff6IfxxVceIMM6oFAc9Zig' \
  --header 'x-secret-key: HYX5X4is3a4bnJJo4lXM936bFD6B8iMeAtXijNvHXMI==' \
  --header 'x-request-id: 546d7a200cd8cb45d8ac'
  --data '{
	"countryCode": "TZ",
	"accountNo": "8070089773",
	"serviceCode": "TZ-BANK-B2C",
	"amount": 1000,
	"msisdn": "CORUTZTZ:0150078564433",
	"narration": "SALARY ADVANCE TO JOHN DOE",
	"currencyCode": "TZS",
	"recipientNames": "JOHN DOE",
	"transactionRef": "RTHSY3837734",
	"transactionDate": "2023-02-16 17:00:01",
	"callbackUrl": "http://example.com/webhook"
}'

Last updated