How to integrate Airtel Money and Moov Money into your website in Gabon
By Gabon Connect
Integrating Airtel Money and Moov Money into a website means connecting your server to the payment platforms of both operators, so customers pay from their phone without a bank card. The customer receives a request on their phone, approves it with their PIN, and your website receives the confirmation. This guide covers what to plan, in order.
Why Mobile Money rather than a bank card
In Gabon, many of your customers pay with their phone and have no bank card they can use online. A website that only accepts cards loses those customers at the exact moment they want to pay. Offering Airtel Money and Moov Money means accepting the payment method they already carry.
The two networks coexist: a Moov customer does not pay with Airtel Money, and the reverse is also true. A serious payment flow therefore offers both and lets the customer choose their operator before entering their number.
Getting access to the operators’ APIs
Airtel publishes its technical documentation on its developer portal, developers.airtel.africa. Gabon appears in the list of countries, and choosing Gabon leads to developers.airtel.ga, which asks you to create an account before reading the documentation. The payment section is called “Collection”, and the payment triggered on the customer’s phone is called “USSD push”.
For Moov Money in Gabon, we found no public documentation of the merchant API at the date this guide was last updated. Access is arranged with Moov Africa Gabon, which opens the merchant account and provides the technical details.
A second route is a local payment aggregator that has already signed with both operators and exposes a single interface for both. You save time and effort, you pay a commission to the intermediary, and you depend on its availability. The right choice depends on your volume and on the time you can spend on paperwork.
- A merchant account opened in the company’s name, with its documents (RCCM, NIF).
- Test credentials, then production credentials after approval.
- A callback address on your server, registered with the operator or the aggregator.
The payment flow, step by step
This is the flow we set up, as it works on the platforms we run for our clients, including the subscription payments described in our case studies.
- The server creates the invoice and calculates the amount. The browser never sets the price: an amount sent by the customer can be tampered with.
- The customer chooses Airtel Money or Moov Money and enters their number.
- The server sends the payment request to the operator, which displays it on the customer’s phone.
- The customer approves with their PIN on their phone. Your website never sees that PIN.
- The operator notifies your server of the result. The server checks the notification, then marks the invoice as paid.
- The customer sees the confirmation on screen and receives a receipt.
Between step 3 and step 5, time passes while the customer approves. The page has to wait without freezing: a clear message (“Approve the payment on your phone”), then regular checks of the invoice status.
Security points you cannot skip
- The amount is calculated on the server, never read from the form.
- The operator’s notification is checked before it is trusted: signature, origin, amount and reference compared with the invoice.
- The same notification received twice only credits once. Operators can resend a message.
- Access keys are stored on the server, outside the published code and outside the browser.
- Every attempt is logged: who, how much, which operator, which result. That log settles disputes.
On our projects, this module is covered by automated tests: an accepted payment, a declined payment, a duplicate notification, a forged notification. It is the part of the site where a mistake costs money, so it deserves testing at every update.
When the request does not go through
A payment request can fail for ordinary reasons: insufficient balance, phone switched off, weak network, a customer who does not approve in time. The site must say so plainly and offer to try again, without creating a second invoice.
We also add a fallback payment link, sent to the customer when the direct request does not go through. They can pay later, from another phone, without going through the whole flow again.
Reconciliation and accounting
A payment is only complete once it appears in the right place in your accounts. Each payment carries a reference linking the invoice, the operator’s transaction and the receipt. Automatic reconciliation compares what your site recorded with what the operator actually paid out, and flags any gap.
A marketplace needs more: holding funds until delivery, then splitting them between seller and courier. We built this for one of our clients, with PDF receipts and payment history.
Where to place the payment: website, app or link
The same connection to the operators can serve several points of sale. The server stays the same, only the screens change.
- On a website: a payment button at checkout or on the invoice, with no mandatory account creation if your business allows it.
- In a mobile app: the same flow, with the advantage that the customer’s number is often already known.
- By link: a payment link sent by SMS, email or WhatsApp, useful for a one-off invoice or a reminder.
Start with the point that brings in the most revenue. The others connect to the same server later, without redoing the integration.
Testing before opening to the public
A payment is tested as a complete circuit, from the customer’s click to the accounting entry. Operators and aggregators usually provide a test environment, separate from production, with its own credentials.
- Accepted payment: the invoice switches to “paid” only once and the receipt is sent.
- Declined or abandoned payment: the invoice stays open and the customer can try again.
- Notification received twice: a single credit.
- Forged notification or different amount: rejected and logged.
- Server unavailable for a few minutes: payments approved in the meantime are picked up correctly.
After launch, watch the first days closely: the share of requests that succeed, notification delays and complaints. They tell you whether the flow is clear for your customers.
Transaction fees
Each payment collected carries fees set by the operator or the aggregator in your merchant contract. They are not part of our service and vary with the contract, the volume and the channel you choose.
Ask for the exact fee schedule before signing, and decide who bears it: you, or the customer through an adjusted amount. That choice is made on the server, when it calculates the invoice, and must be shown clearly to the customer before they approve.
Timelines and budget
Our “Mobile Money payment gateway” service is offered from 551,200 FCFA excl. tax, with an indicative timeline of 7 to 14 days once access has been obtained. The exact price depends on your site, the number of payment flows and the reconciliation you need.
The longest delay is often not technical: it is opening the merchant account with the operator. Start that process at the very beginning of the project.
If you need to bring several payment methods together across a website, an app and a marketplace, our “Multichannel payment system” service is offered from 2,754,200 FCFA excl. tax.
Frequently asked questions
Can a website accept both Airtel Money and Moov Money?
Yes. They are two separate integrations, one per operator, or a single one if you use an aggregator that covers both. The customer chooses their operator before entering their number.
Where can I find the Airtel Money API documentation for Gabon?
On the Airtel Africa developer portal, developers.airtel.africa. Choosing Gabon leads to developers.airtel.ga, which requires an account to access the documentation.
Is there public documentation for the Moov Money Gabon API?
We did not find any at the date this guide was last updated. Technical access is requested from Moov Africa Gabon when the merchant account is opened.
Does the customer enter their PIN on my website?
No. They approve the payment on their own phone. Your website never sees their PIN.
What happens if the customer does not approve the request?
The transaction stays pending and then fails. The site says so clearly, offers to try again and can send a fallback payment link.
How much does the integration cost?
Our Mobile Money payment gateway is offered from 551,200 FCFA excl. tax. The operator’s or aggregator’s fees come on top and are billed by them.
Can the integration be tested before opening it to customers?
Yes. Operators and aggregators usually provide a test environment with its own credentials. We check accepted, declined, duplicate and forged payments there before going live.
Do I need a registered company?
Yes, for a merchant account: the operator or aggregator asks for the company’s documents, including its RCCM and NIF.
The related service
Mobile Money Payment Gateway (API)
Indicative price, timeline and details of the service on its page.
See the serviceSources
- Airtel Africa developer portal (choose a country; an account is required for Gabon)(developers.airtel.africa)
- Airtel documentation, Collection section, USSD push(developers.airtel.africa)
- Our case studies: subscription payments and marketplace payments by Mobile Money(gabonconnect.com)