Advertisement
Online Payments & eCommerce

How to Accept Airtel Money Online — Step‑by‑Step Guide for Small Businesses

Hurkson Hurkson 0

Learn how to integrate Airtel Money payments online for your eCommerce site or digital business. This step‑by‑step guide will walk you through getting approved, obtaining API keys, configuring online payment acceptance, and testing your system.

In Uganda and across East Africa, mobile money payments are among the most popular ways for customers to pay online — especially Airtel Money and MTN MoMo. Allowing your eCommerce business to accept Airtel Money online dramatically increases conversion because customers can pay directly from their wallets without a bank card.

In 2023, Airtel Money launched open APIs to support innovators and developers so that businesses can integrate secure mobile money payments directly into their digital platforms.

This guide shows you how to set up Airtel Money payments for your business — whether you’re using a payment aggregator or integrating directly via Airtel’s developer system.

1. Decide: Direct API or Payment Gateway

Option A — Use a Payment Gateway (Easiest)

Before using Airtel’s own API, many small businesses use payment gateways which already support Airtel Money plus other options like MTN, card payments, and bank transfers.

Popular payment gateways in Uganda that support Airtel Money include:

  • Pesapal (now supports Airtel Money payments)
  • Flutterwave (accepts Ugandan mobile money via API)
  • Paystack (offers mobile money integrations)

👉 These gateways handle the painful security, API maintenance, callback notifications, and compliance for you. They’re perfect if you want a fast and reliable integration with minimal coding.

2. Create or Register Your Airtel Money Merchant Code

Even if you are using Airtel’s own API, you may need a merchant ID or code linked to an Airtel Money business account.

Steps to get a Merchant Code

  1. Dial Airtel Money Merchant USSD:
    • Typically: *185*10*10# (in Uganda)
    • Follow prompts to register your business name
    • Accept terms
    • Confirm with your Airtel PIN
  2. You’ll receive a 7‑digit merchant code in SMS.

This code identifies your business in Airtel’s systems and is necessary for both offline Airtel Money Pay acceptance and some API integrations.

3. Join Airtel’s Developer Portal and Set Up an App

If you plan to integrate directly:

Sign Up and Create a Developer Account

  1. Visit the Airtel Developer Portal (part of the Airtel Africa platform) and register your account.
  2. After registering, create a new application in the dashboard.
  3. Give your app a name, description, and purpose (e.g., “HurkWise eCommerce Payments”).

Enable “Collection” or “Mobile Money” API

Once your app is created:

  1. Go to the Products section inside your application.
  2. Add Account & Collection API (or similar payment API).
  3. Select the countries and services you want payments supported in.
  4. Initially, the API status may be pending approval. You’ll need to contact support through the portal or Airtel business support for activation.

4. Obtain Your API Keys

After approval:

  1. Go to Key Management in your Airtel Developer dashboard.
  2. You’ll see:
    • Client ID
    • Client Secret
  3. These keys allow your website to securely connect to Airtel’s payment system.
  4. There are usually two modes:
    • Test (Sandbox) — for testing
    • Live — accepts real payments once approved

Always use test keys first and only switch to live keys after verifying your setup works.

5. Integrate Airtel Money Payments in Your System

Developer/API Integration

If coding yourself or using a custom platform:

  • Use HTTP requests to send payment requests to Airtel’s API with your client_id and client_secret.
  • Capture payment callbacks — these are notifications your server receives when a payment is completed.
  • Store the transaction status and update order records accordingly.

Example flows for other Airtel Money API implementations show that you must use secure authentication and unique references for each transaction (usually generated server‑side).

If you’re building this yourself, always follow Airtel’s documentation exactly — it contains endpoints and security rules that must be respected to avoid failed payments.

6. Configure Your Website or eCommerce Platform

If you use platforms like:

  • WooCommerce (WordPress)
  • OpenCart
  • Shopify

You can often install plugins or connectors that handle the Airtel Money API for you. If there is no pre‑built plugin:

  1. Create a custom payment plugin
  2. Add Airtel Money as a payment method in the checkout
  3. Trigger a payment request to Airtel’s API when the customer selects Airtel Money
  4. Wait for confirmation before marking orders as paid

Some hosting providers (e.g., managed eCommerce hosting) offer Airtel Money‑enabled solutions that simplify integration.

7. Test Payments Before Going Live

Before accepting real customer payments:

  • Use test API keys (sandbox) to process fake transactions.
  • Ensure:
    • Payment requests succeed
    • Your system handles errors
    • Callbacks update orders correctly

Only switch to real (live) keys after thorough testing.

8. Monitor and Maintain Your Payment System

Once live:

✅ Regularly track successful and failed transactions
✅ Ensure callback URLs are secure and not exposed publicly
✅ Update API keys if necessary
✅ Monitor logs for unusual patterns

Since mobile money fraud and attack attempts can occur if not secured, always follow secure coding practices (validate responses, use HTTPS, etc.).

9. Additional Ways to Accept Airtel Payments Online

Via Virtual Debit Cards

Customers with Airtel Money Virtual Mastercard can also pay online where cards are accepted. This gives you another revenue stream beyond just mobile money.

Via Payment Aggregators

Using platforms like Pesapal, Flutterwave, or Paystack means you get:

  • Card payments
  • Airtel Money
  • MTN Money
  • Bank transfers

…all from one integration.

Conclusion

Accepting Airtel Money online opens your business to millions of mobile money users in Uganda and beyond. By integrating Airtel’s mobile money option through either a trusted payment gateway or the official Airtel API, you can create a secure, convenient way for customers to pay.

The most important steps are:
✔ Get merchant code
✔ Register a developer app
✔ Obtain secure API keys
✔ Integrate into your checkout system
✔ Test thoroughly
✔ Go live confidently

With this setup, your business will be ready to capture mobile money payments efficiently and safely.

💡 Pro tip: If API integration feels technical, use a payment gateway partner first. You can always switch to direct API later as your business scales. You can still contact Hurk Tech to get everything sorted.

Related Story

Leave a Reply

Your email address will not be published. Required fields are marked *