Hubtel WooCommerce Payment Gateway Plugin – Documentation

📦 Overview

The Hubtel WooCommerce Payment Gateway Plugin allows Ghanaian e-commerce stores to accept secure payments via Hubtel. This includes support for:
  • Mobile Money (MTN, Telecelcash, AirtelTigo)
  • Bank Cards (Visa, Mastercard)
  • Wallets (Hubtel Wallet, G-Money, Zeepay)
  • Bank Transfers and GhQR
Requires WooCommerce and a Hubtel merchant account.

🔧 Features

  • Accept payments via Hubtel directly or through redirect
  • Real-time order status updates
  • Supports sandbox mode for testing
  • Secure authentication using Hubtel Client ID and Secret
  • Mobile-optimized checkout
  • Multi-language support (via .pot file)

🛠 Installation

  1. Go to WordPress Admin → Plugins → Add New → Upload Plugin
  2. Select the ZIP file and click “Install Now”
  3. Click “Activate Plugin”

⚙️ Configuration

Go to: WooCommerce → Settings → Payments → Hubtel Fill in the following fields:
  • Enable Gateway
  • Title (e.g. Pay with Hubtel)
  • Description
  • Client ID (from Hubtel Dashboard)
  • Client Secret
  • Callback URL (auto-generated or custom)
  • Return URL
  • Enable Sandbox Mode (for testing)
Note: POS Sales ID is not required.

💰 How It Works

🔁 Redirect Checkout Flow

  1. Customer selects “Pay with Hubtel” at checkout
  2. They are redirected to Hubtel’s secure payment page
  3. Payment is completed on Hubtel
  4. Customer is redirected back to your site
  5. Order status is automatically updated

🔄 Webhook & Callback Handling

If configured, Hubtel will send real-time payment updates to your callback URL: Recommended URL: https://yourdomain.com/?wc-api=hubtel_gateway This ensures accurate status tracking even if the customer closes their browser.

🧪 Sandbox Testing

  • Enable Sandbox Mode
  • Use Hubtel-provided test credentials
  • After testing, disable sandbox and use live credentials

🚨 Troubleshooting

  • Payment not working? Check Client ID/Secret
  • Webhook not triggering? Confirm callback URL is registered with Hubtel
  • Not showing at checkout? Ensure the plugin is enabled

🔐 Security

  • Uses Basic Auth for API requests
  • Secured with HTTPS and WordPress best practices

🛡 Support

Need help? Contact us: 📧 support@entechnologygh.com 🌐 entechnologygh.com Ticket sytem(Coming soon)

📄 Changelog

v1.0.0 – Initial Release
  • Redirect flow via Hubtel Online Checkout API
  • Support for Mobile Money, Card, and Wallet
  • Admin configuration and sandbox support