Hubtel Payment Gateway

Integrate Ghana-based mobile money, card, GHQR, and SMS payments via Hubtel APIs.

Updated Mar 14, 2026
One-click install
npx skills add https://github.com/AfricanDigitalAssetFramework/africa-stack-skills --skill hubtel-payment-gateway
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Hubtel Payment Gateway
Source: https://github.com/AfricanDigitalAssetFramework/africa-stack-skills/tree/main/west-africa/ghana/hubtel
Command: npx skills add https://github.com/AfricanDigitalAssetFramework/africa-stack-skills --skill hubtel-payment-gateway

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Hubtel enables Ghanaian merchants to accept payments across MTN Mobile Money, Vodafone Cash, AirtelTigo, cards, GHQR, and SMS, unifying payments and disbursements through a single API surface.

Core Features & Use Cases

  • Online Checkout: Generate a hosted checkout URL to collect payments from customers.
  • Direct Receive Money: Initiate payments directly from a customer's mobile wallet without redirect.
  • Disbursements: Send money to customer mobile wallets or bank accounts.
  • Status & Webhooks: Track transaction status via callbacks and status queries.
  • SMS & Notifications: Deliver transactional messages and alerts to customers.

Quick Start

Configure your Hubtel merchant account and begin processing payments by initiating an online checkout or a direct receive money flow.

Frequently Asked Questions about Hubtel Payment Gateway

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I integrate mobile money payments in Ghana via API?

To integrate mobile money payments in Ghana via API, use Hubtel's unified API to accept payments across MTN Mobile Money, Vodafone Cash, and AirtelTigo through structured JSON payloads and HTTP Basic Authentication.

How do I set up webhook callbacks for online checkout payment status updates?

Setting up webhook callbacks for online checkout payment status updates involves configuring your Hubtel merchant account to receive webhook-driven status notifications for transaction tracking and comprehensive error handling.

Can I send money directly to customer mobile wallets without a redirect?

You can send money directly to customer mobile wallets without a redirect by using Hubtel's disbursement and direct receive money API endpoints to initiate payments directly from a customer's mobile wallet.

What payment methods are supported by the Hubtel Payment Gateway API?

The Hubtel Payment Gateway API supports MTN Mobile Money, Vodafone Cash, AirtelTigo, cards, GHQR, and SMS, enabling merchants and fintechs to unify payments and disbursements through a single API surface.

What authentication is required for the Hubtel payments API?

Hubtel's payments API requires HTTP Basic Authentication to satisfy authentication for structured JSON payloads across online checkout, receive money, send money, and webhook-driven status update endpoints.