Utility Payments

Use this endpoint to pay for utility bills from your the customer wallet. Both customer wallets and disbursement wallets are supported.

Wallet to Mobile

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

Use this endpoint to pay utility bills directly from a wallet. Note that only customer wallets and disbursement wallets can be used to make utility payments. Utility payments cannot be made 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	Must be set to TZ-BILLER
amount*	number	Amount to pay
msisdn*	string	MSISDN of the customer recipient.
narration*	string	Narration for this transfer
currencyCode*	string	Currency code. Currently only TZS is supported
recipientNames*	string	First and last names of the customer
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

{
  "status": "SUCCESS",
  "reference": "GEPG:991040169765",
  "description": "DAWASA\nName: ALEX JOHN KIRIA\nControl#: 991040169765\nTZS 83,981.50\nReference: 0278372593",
  "meta": [
    {
      "name": "DAWASA",
      "amount": "83981.50",
      "institution": null,
      "type": "PART",
      "desc": "ALEX JOHN KIRIA - Malipo ya Bill Kwa 82024",
      "chargeType": null,
      "charge": null
    }
  ]
}

401 Invalid Credentials

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

cURL

curl --request POST \
  --url https://sandbox.temboplus.com/tembo/v1/payment/biller \
  --header 'content-type: application/json' \
  --header 'x-account-id: ff6IfxxVceIMM6oFAc9Zig' \
  --header 'x-secret-key: HYX5X4is3a4bnJJo4lXM936bFD6B8iMeAtXijNvHXMI==' \
  --header 'x-request-id: 546d7a200cd8cb45d8ac'
  --data '{
	"countryCode": "TZ",
	"accountNo": "8800175745",
	"serviceCode": "TZ-BILLER",
	"amount": 1200,
	"msisdn": "255717898844",
	"narration": "LUKU TEST PAYMENT",
	"currencyCode": "TZS",
	"recipientNames": "ALEX JOHN KIRIA",
	"transactionRef": "YHSE78473DN",
	"transactionDate": "2024-08-12 16:00:01",
	"callbackUrl": "https://example.com/my-webhook-url",
	"meta": {
	  "billerCode": "LUKU",
	  "billerReference": "458574736222"
	}
}'

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