Skip to Content

Airtel Money POS Payments

by
Odoo

$ 69.66

In-App Purchases
v 19.0 Third Party
Versions 17.0 18.0 19.0
You bought this module and need support? Click here!
Versions 17.0 18.0 19.0
For Odoo 17.0 · 18.0 · 19.0 — Community & Enterprise

Airtel Money POS Payments

$99 $69 ★ 30% LAUNCH OFFER

Take Airtel Money at the till — the honest, complete way. Push a PIN prompt to the customer’s phone, confirm their registered name before you charge, recover a payment that timed out, refund from the back office and check your wallet balance — all in one app that carries its own Airtel connection. Nothing else to buy.

✅ PIN push & auto-confirm ✅ Payer-name check ✅ Refund & balance ✅ 14 Airtel markets ⭐ 90 days free support
📚 Full Documentation 💻 Try it live
Airtel Money POS Payments for Odoo
14

Airtel Money markets, one API — the market and currency are stated per account and sent on every call, so a Zambian till can never address money to another country.

1

Order per payment — every Airtel receipt is single-use, claimed atomically for exactly one sale. A dropped network never settles it twice, and a cashier can never forge one.

0

Unconfirmed payments marked paid — the till never trusts a callback as proof; it re-queries Airtel until Airtel itself confirms, with a one-minute backstop job.

★ Implementation included Features Every feature Setup in 4 steps Africa Mobile Money FAQ Support
See it in action

One red popup. Every Airtel payment, start to finish.

Real screens from the app running on Odoo — the till popup, the back office, and the transaction ledger.

Airtel Money popup: enter the customer phone and send a PIN push
01 · AT THE TILL

Push a PIN prompt to the customer’s phone

Pick Airtel Money at payment, type the number with your market’s dial-code shown, and send. The customer approves with their Airtel PIN; a live timeline runs Prompt sent → Awaiting PIN → Confirmed, and the till re-queries Airtel every few seconds until it is really paid — then closes the sale on its own.

Airtel Money transaction ledger with references, receipts and colour-coded status
05 · ONE LEDGER

Every shilling, logged and sliceable

Each payment lands in the Airtel Money log — date, phone, amount, reference, Airtel Money ID, channel and status — colour-coded and totalled. Successful, Pending, Request Sent, Failed and Recovered at a glance; filter, group, pivot and graph for reconciliation.

Airtel Money account form: market, environment, manager-only credentials
06 · SAFE BY DESIGN

Cashiers charge; only managers hold the keys

Client ID, secret and callback token are manager-only; the ledger is read-only for cashiers. The money path runs server-side under strict, validated wrappers — so a cashier takes payments without ever reading credentials or forging a “paid” row. Amounts follow the market’s currency decimals: K10.50 is charged as K10.50, never rounded away.

Every feature, in detail

Open any panel — nothing hidden, nothing oversold

Twenty-one capabilities, grouped. Every claim is code-verified and honest about what Airtel’s public API does — and doesn’t — expose.

📱 At the till
PIN-push collection
Merchant-initiated USSD/PIN push (POST /merchant/v1/payments/) — the direct M-Pesa STK-Push equivalent. The customer approves on their handset.
Payer-name & KYC confirm
Shows the registered name, active status and PIN-set flag before you charge. Optional per account, cached briefly, and never blocks the sale if the lookup is unavailable.
Live status timeline
Prompt sent → Awaiting PIN → Confirmed / Failed, polled every few seconds from the authoritative Airtel status endpoint — the cashier always knows where the payment stands.
“Already paid?” recovery pane
Reclaim a confirmed-but-late payment by phone or receipt tail, amount-matched to the open order — recovers a timed-out prompt without leaving the POS.
Market-aware phone entry
The dial code for the account’s market is shown, local formats are normalised to a full MSISDN, and ambiguous numbers are refused — across all 14 Airtel markets.
Honest about QR & till-listening
Airtel’s public API exposes no QR generation and no notification when a customer pays a merchant code unprompted — so this app doesn’t pretend to. The supported flow is the PIN push, done properly. (Need scan-to-pay? That’s M-Pesa and MTN — see the Africa Mobile Money line below.)
💰 Money-correct & safe
Exact-decimal amounts
Amounts are quantised to the market currency’s ISO-4217 decimals with round-half-up — zero-decimal currencies (KES, UGX, RWF, TZS…) and two-decimal (ZMW, GHS…) both charged correctly.
Single-use receipts (atomic claim)
Each receipt is claimed for exactly one order via a race-free database update — two cashiers hitting the same payment can never both win.
Same-order idempotent re-claim
If the network blips after a payment is claimed, re-polling the same order returns success again — it never double-charges and never loses the sale.
Double-prompt guard
“Try again” re-attaches to the prompt already on the phone instead of sending a second one — the customer is never asked to pay twice.
Currency guard
A constraint refuses to let a till whose currency differs from the Airtel account’s market currency take a payment — no silent cross-currency charge.
No cross-till fallback
A till with no Airtel account raises a clear configuration error — money is never silently routed into another branch’s wallet.
💼 Back office
Refunds with audit trail
Manager-only full-amount refund (POST /standard/v1/payments/refund) with a required reason, refund-status polling and a complete chatter record.
Wallet balance check
Read the merchant wallet balance on demand (GET /standard/v1/users/balance), stamped with the time it was fetched.
Transaction ledger & analytics
A per-payment ledger with list, pivot and graph views, filtered and grouped by account, status, POS and date for clean reconciliation.
Manual-review flags
Receipt conflicts and 2-hour-stale prompts are flagged for review instead of being silently settled or lost.
🔒 Trust & platform
Cashier-safe by construction
Ledger and accounts are read-only to cashiers; every money-moving method runs server-side behind a validated wrapper — a cashier cannot forge a “success” row over RPC.
Callbacks are never proof
An inbound callback only triggers an authoritative re-query; a one-minute background job re-polls anything still pending. A forged POST can never settle a sale.
Fail-closed status mapping
Only Airtel’s explicit success/failure codes settle a payment; unknown codes are recorded and surfaced, never guessed into “paid”.
Multi-company & per-company rules
Accounts and transactions are scoped by company record rules — a group can run several branches without their Airtel data mixing.
Odoo 17, 18 & 19 · Community & Enterprise
Ships for all three supported Odoo majors, on both Community and Enterprise, and installs cleanly with no third-party dependencies beyond Point of Sale.
Setup in 4 steps

From install to first payment in one afternoon

Airtel Money account form
1 · Install    2 · Add your account

Install the app — an Airtel Money menu appears. Add an account, choose your market, paste your Client ID and Secret, and hit Test Connection.

POS payment method with Airtel Money terminal
3 · Link a payment method    4 · Sell

Create a POS payment method with terminal Airtel Money, point it at your account, add it to your register. Open a session and collect — every payment lands in the log.

Implementation included with your purchase - free setup

We don’t just sell the app — we get you live on Airtel Money.

Buying Airtel Money POS Payments includes hands-on implementation by our engineers: installed on your Odoo, connected to your Airtel merchant account, configured for your market, and proven with a real payment before we hand it over. No hourly fees, no “figure it out yourself.”

The wider line

Need more than Airtel? The Africa Mobile Money line

Each rail is its own app so you pay only for the channel you use. Run several rails? The multi-rail apps put M-Pesa, MTN and Airtel in one till.

Airtel Money POS
This app — Airtel at the till, done right.
MTN MoMo POS
MTN at the till — PIN push plus MoMoPay scan-to-pay QR.
Africa Mobile Money POS
M-Pesa + MTN + Airtel in one popup, branded per rail.
FAQ

Common questions

Do I need to buy anything else to take Airtel Money?
No. This app is complete on its own — it carries the Airtel Money connection, the account configuration and the transaction ledger. You download exactly one app; it depends only on Odoo’s Point of Sale.
Does it do QR or “pay the till” codes like M-Pesa?
Honestly, no — and neither does any Airtel app that’s telling the truth. Airtel’s public API exposes no QR generation and no notification for customer-initiated merchant-code payments. The supported, reliable flow is the PIN push, which this app does thoroughly. If you need scan-to-pay, that’s M-Pesa and MTN — our Africa Mobile Money POS covers those rails.
Which Airtel API does it use? Does it work in Zambia?
The Airtel Africa Open API v1 collection endpoint (/merchant/v1/payments/), with market and currency sent as headers (e.g. X-Country: ZM, X-Currency: ZMW). Airtel Money is live across Airtel Africa’s 14 markets, Zambia included.
Can a cashier see my credentials or fake a payment?
No. Secrets are manager-only at the field level; the ledger is read-only for cashiers and the money path runs under validated server-side wrappers. A cashier takes payments without ever reading credentials or writing a “paid” row.
What happens if the confirmation callback is missed?
The till never trusts a callback as proof. It re-queries Airtel every few seconds until Airtel confirms, and a background job re-polls any pending payment every minute — so a dropped callback never loses a sale, and a payment that comes in late can be recovered at the counter.
🏆
90 days of free support included with your purchase
Real people, business hours — including help getting your Airtel credentials and going live. Start with the full documentation.
⭐ Included — no extra cost
✉️
Email
reach@aminitechsolutions.com
📞
Phone / WhatsApp
+254 746 883 809
💻
Try it live
demo.aminitechsolutions.com
Availability
Odoo Online
Odoo.sh
On Premise
Odoo Apps Dependencies • Point of Sale (point_of_sale)
• Discuss (mail)
• Inventory (stock)
• Invoicing (account)
Lines of code 2025
Technical Name aminitech_airtel_pos
LicenseOPL-1
Websitehttps://www.aminitechsolutions.com 
Odoo Proprietary License v1.0

This software and associated files (the "Software") may only be used (executed,
modified, executed after modifications) if you have purchased a valid license
from the authors, typically via Odoo Apps, or if you have received a written
agreement from the authors of the Software (see the COPYRIGHT file).

You may develop Odoo modules that use the Software as a library (typically
by depending on it, importing it and using its resources), but without copying
any source code or material from the Software. You may distribute those
modules under the license of your choice, provided that this license is
compatible with the terms of the Odoo Proprietary License (For example:
LGPL, MIT, or proprietary licenses similar to this one).

It is forbidden to publish, distribute, sublicense, or sell copies of the Software
or modified copies of the Software.

The above copyright notice and this permission notice must be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
DEALINGS IN THE SOFTWARE.

Please log in to comment on this module

  • The author can leave a single reply to each comment.
  • This section is meant to ask simple questions or leave a rating. Every report of a problem experienced while using the module should be addressed to the author directly (refer to the following point).
  • If you want to start a discussion with the author or have a question related to your purchase, please use the support page.