Skip to main content

​
Collect payments with Hubtel

HUBTEL sends a mobile money prompt to the payer’s phone through Hubtel’s merchant account API. The payer approves it on their handset, and Hubtel confirms the result on a callback. Available to ISPs in Ghana (GH), alongside MTN MoMo, PawaPay, Paystack, PayPal, and DPO.

​
Before you start

  1. Complete Hubtel merchant onboarding in an account owned by the ISP.
  2. In the Hubtel dashboard open API & Integrations → API Credentials and collect the client ID and client secret.
  3. Confirm your workspace has a public HTTPS domain, so Hubtel can reach the callback.

​
Configure the gateway

1

Open Settings → Payments → Hubtel

Select Hubtel from the payment marketplace.
2

Enter the client ID

Hubtel client ID (required) comes from API & Integrations → API Credentials.
3

Enter the client secret

Hubtel client secret (required) is stored as a secret and is not echoed back into the form after saving. The pair is sent as HTTP basic authentication on every request.
4

Run a controlled test payment

Pay a small amount from the captive portal and confirm the prompt arrives on the handset and the payment reaches the ledger.

​
Credentials

​
Callback URLs

Settings → Payments shows https://<your-host>/api/hubtel/callback. It is also sent with every payment request as the primary callback, so there is normally nothing to register — but confirm it is not blocked by a firewall or WAF rule.

​
What the payer must provide

A Ghanaian mobile money number. The network is detected from the number’s prefix, and a number whose prefix is not recognized is refused before any request reaches Hubtel: Numbers are accepted with or without the 233 country code and with or without a leading zero. The currency is your account’s configured currency, defaulting to GHS. Authorization happens on the handset, so no Hubtel domain needs to be added to the captive walled garden.

​
How a payment completes

1

Request

Centipid Billing posts the charge to Hubtel’s send-mobile-money endpoint with the amount, the payer’s number, the detected channel, and a unique client reference.
2

Authorization

The payer approves the prompt on their handset.
3

Confirmation

Hubtel posts the outcome to the callback, which records the payment and applies the subscriber’s package.

​
Troubleshooting

For every gateway’s fields in one place, see the credential reference.