Skip to main content

​
Collect payments with DaliPay

DALIPAY collects by wallet push. The payer enters their number on the portal, a PIN prompt appears on their phone, and they approve it there. They never leave the portal page. Offered in the country catalog for Tanzania (TZ). Centipid Billing uses two calls from DaliPay’s Collections API:
  1. POST /api/v1/collections sends the PIN prompt to the payer’s number.
  2. GET /api/v1/collections/{uuid}/status reports whether it was paid.
Nothing is credited until the status reads success.

​
Before you start

Register a merchant account at dalipay.co.tz for the ISP. Test keys work straight away and simulate every payment. Live payouts (“Toa Pesa”) need DaliPay to verify the account’s KYC first.

​
Configure the gateway

1

Generate an API key pair in DaliPay

Under API keys, generate a pair for Live (or Test to try it first). Copy the secret key straight away: DaliPay shows it only once.
2

Open Settings → Payments → DaliPay in Centipid

Enter the Public key and Secret key.
3

Paste the webhook URL into DaliPay

Copy the Webhook URL Centipid shows under Callback URLs into DaliPay’s Settings. Copy the callback secret DaliPay shows beside it back into Centipid.
4

Run a controlled test payment

Pay a small amount from the captive portal, approve the prompt on the phone, and confirm the payment reaches the ledger.

​
Credentials

​
Callback URL

Paste /api/dalipay/callback on the ISP’s domain into DaliPay Settings (the settings page shows the full URL). DaliPay calls it when a payment succeeds or fails, and does not retry. So Centipid also checks the payment’s status every 5 seconds for about 3 minutes after the prompt is sent. That check is what connects the payer if the webhook is lost. A webhook whose signature does not match the callback secret is rejected.

​
Networks

DaliPay needs to know the payer’s network, and the portal only asks for a number, so Centipid reads it from the prefix: Any other number, TTCL (073) for example, is refused before a prompt is sent. AzamPesa is not offered, because its wallets are not tied to a prefix.

​
Troubleshooting

  • “Unable to send the DaliPay payment prompt”: a key is wrong or revoked, or DaliPay’s IP whitelist is on and does not include Centipid’s servers (DaliPay answers 403). DaliPay’s exact response is in the application log.
  • “Enter a Vodacom, Airtel, Tigo or Halotel number”: the number’s prefix is not in the table above.
  • Test payments succeed but no money arrives: the keys start gw_pk_test_. Test keys only simulate. Generate a Live pair.
  • The payer paid but did not connect: search the payment by DaliPay’s reference (col_…), shown in the DaliPay Collections ledger.