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

Name	Type	Description
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

Name	Type	Description
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

200 Success

{
  "statusCode": "PENDING_ACK",
  "transactionRef": "20f807fe-3ee8-4525-8aff-ccb95de38250",
  "transactionId": "X50jcLD-U"
}

401 Invalid Credentials

{
    "statusCode": 401,
    "reason": "INVALID_CREDENTIALS"
}    

cURL

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

Webhook Callback

The provided web hook will be called with an update of the transaction. If the transaction succeeded or failed, the web hook endpoint will be called with a POST method. See the sample payload below for more information

{
  "statusCode: "PAYMENT_ACCEPTED",
  "transactionRef: "20f807fe-3ee8-4525-8aff-ccb95de38250",
  "transactionId": "X50jcLD-U"
}