Wallet to Mobile

Use this endpoint to transfer funds from a wallet to a mobile phone number

Wallet to Mobile

POST https://sandbox.temboplus.com/tembo/v1/payment/wallet-to-mobile

This endpoint facilitates the transfer of funds from either a customer wallet or your disbursement wallet to a mobile subscriber. It's important to note that only customer wallets and disbursement wallets are eligible for this type of transaction. You cannot initiate fund transfers from your collection wallet to a mobile subscriber.

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	The MNO of the recipient mobile wallet. Supported codes are: TZ-TIGO-B2C, TZ-AIRTEL-B2C
amount*	number	Amount to be transferred
msisdn*	string	MSISDN of the recipient
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/wallet-to-mobile \
  --header 'content-type: application/json' \
  --header 'x-account-id: ff6IfxxVceIMM6oFAc9Zig' \
  --header 'x-secret-key: HYX5X4is3a4bnJJo4lXM936bFD6B8iMeAtXijNvHXMI==' \
  --header 'x-request-id: 546d7a200cd8cb45d8ac'
  --data '{
	"countryCode": "TZ",
	"accountNo": "70089773",
	"serviceCode": "TZ-TIGO-B2C",
	"amount": 1000,
	"msisdn": "255713809050",
	"narration": "MOBILE PAYOUT",
	"currencyCode": "TZS",
	"recipientNames": "Alex Kaiza",
	"transactionRef": "20f807fe-3ee8-4525-8aff-ccb95de38250",
	"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"
}