Connect your Hubtel account

Customers pay by MoMo and card into your own Hubtel account. Connect it once, test it, and paid orders start reaching you.

In the dashboardSettings › Shop › PaymentsAll guides
On this page

01Enter your Hubtel details

  1. In your dashboard, open Settings, then the Payments tab.
  2. Under Hubtel, fill in the Hubtel collection account, the API client id and the API secret.
  3. If you have one, add your SMS sender id: up to 11 characters, registered with Hubtel.
  4. Choose Connect. Your keys are stored encrypted and never shown again. To change them, type new ones and choose Save.

02Test the connection

Choose Test the connection. A GH₵1.00 prompt goes to your number and is reversed, so you know payments will reach your account.

03The webhook

Beside the test button is your store's webhook: https://api.kioskcluster.com/webhooks/hubtel/your-link. Copy it into your Hubtel account where it asks for a callback address, so Hubtel tells us the moment each payment lands.

Why it matters: an order reaches you once its payment is confirmed. Without the webhook, pending payments are still checked with Hubtel, every 10 minutes.

04Ways to pay

Under Ways to pay, switch on the ones you take:

  • MoMo prompt (on to start)
  • Cards, hosted checkout (on)
  • Cash when customers collect (on)
  • Bank transfer, verified by hand (off)

Unpaid orders expire after 30 minutes to start. When one does, its holds are released and the customer is told.

05Watch the money come in

Money › Payments shows what was paid today, what is pending, and what failed. Pending prompts are checked with Hubtel every 10 minutes once they are 5 minutes old; to check one now, open its menu and choose Reconcile with Hubtel.

Start free14 days, everything on