Afrique Digitale11 min de lecture

Integrer Airtel Money sur un site web en Tanzanie et Zambie : API et frais 2026

Mohamed Bah·Fondateur, Kolonell
24 août 2026
Partager :
Integrer Airtel Money sur un site web en Tanzanie et Zambie : API et frais 2026

Integrer Airtel Money sur un site web en Tanzanie et Zambie : API et frais 2026

Afrique Digitale

Le verdict en trois phrases

Airtel Money est incontournable en Tanzanie et en Zambie mais rarement suffisant seul : il capte environ 28 % du volume tanzanien contre 45 % pour M-Pesa (Vodacom). L'API Airtel Africa expose deux briques claires, collection (encaisser) et disbursement (payer), avec des frais marchands de 1,5 a 2 % et un plafond de 5 000 000 TZS par transaction. Pour un e-commerce serieux, la bonne architecture est multi-operateur des le premier jour, pas un rattrapage six mois plus tard.

L'API Airtel Money en pratique

Airtel Africa a unifie ses marches derriere une seule API REST (OAuth 2.0, jetons Bearer, environnement sandbox puis production). Deux endpoints structurent tout le reste. Le Collection API cree une demande de paiement : le client recoit un prompt USSD sur son telephone, saisit son PIN, et vous recevez un callback signe. Le Disbursement API fait l'inverse : vous poussez des fonds vers un numero Airtel (utile pour rembourser un client ou payer un vendeur).

Le cycle type d'un encaissement : POST /merchant/v1/payments/ avec le montant, la devise (TZS ou ZMW), la reference marchande et le MSISDN du client. Airtel repond immediatement avec un identifiant de transaction, puis notifie le statut final via webhook. Vous devez toujours verifier le statut par un appel GET en complement du callback, car les reseaux mobiles africains perdent des notifications.

Element techniqueDetail 2026 (ordre de grandeur)
ProtocoleREST + OAuth 2.0
DevisesTZS (Tanzanie), ZMW (Zambie)
Endpoint clefCollection + Disbursement
ConfirmationCallback signe + query status
Delai callback5 a 90 secondes
SandboxOui, numeros de test fournis
Plafond transaction5 000 000 TZS / 20 000 ZMW

Onboarding marchand, frais et couverture

L'inscription marchande passe par un partenaire agrege ou par Airtel Money Business directement. Le KYC prend 3 a 7 jours ouvres : registre de commerce, piece d'identite du gerant, justificatif d'adresse et RIB local pour le settlement. Le settlement se fait vers un compte bancaire local ou un wallet marchand, generalement en T+1 a T+2.

PaysPart Airtel (est. 2026)Frais collectionPlafond tx
Tanzanie~28 %1,5 - 2 %5 000 000 TZS
Zambie~40 %1,5 %20 000 ZMW
Ouganda~45 %1,5 %5 000 000 UGX
Kenya~4 %1 - 1,5 %150 000 KES
Rwanda~15 %1,5 %2 000 000 RWF
RDC~30 %2 %variable

La lecon est nette : selon le pays, ignorer Airtel vous coupe de 28 a 45 % des payeurs. En Tanzanie, un checkout M-Pesa seul laisse pres d'un tiers du marche a la porte.

Mini cas pratique

Joyce gere une boutique de cosmetiques en ligne a Dar es Salaam. Sur 400 commandes par mois a 35 000 TZS de panier moyen, soit 14 000 000 TZS de volume, elle n'acceptait que M-Pesa. En ajoutant Airtel Money, elle recupere les clients Airtel : en un trimestre, ses commandes montent a 470 par mois, soit +17,5 %. Cout supplementaire : les frais Airtel a 1,8 % sur la portion Airtel (environ 4 000 000 TZS de volume) = 72 000 TZS/mois. Gain de chiffre d'affaires : +2 450 000 TZS/mois. Le retour sur investissement de l'integration est atteint des la premiere semaine.

Besoin d'un site web professionnel ?

Kolonell crée des sites web qui attirent des clients, optimisés pour le marché sénégalais. Devis gratuit en 2 minutes.

FAQ

Faut-il un compte bancaire tanzanien pour recevoir les fonds ?

Oui, le settlement Airtel Money Business se fait vers un compte local ou un wallet marchand tanzanien. Prevoyez ce compte avant de lancer le KYC, sinon le delai de 3 a 7 jours s'allonge.

Airtel Money et M-Pesa peuvent-ils coexister sur le meme checkout ?

Absolument, et c'est recommande. Un selecteur d'operateur au paiement permet de couvrir plus de 90 % du marche tanzanien en combinant M-Pesa (~45 %) et Airtel (~28 %), plus Tigo Pesa et Halopesa.

Quel est le plafond par transaction ?

En Tanzanie, le plafond marchand est d'environ 5 000 000 TZS par transaction en 2026. Pour des montants superieurs, il faut fractionner ou utiliser un virement bancaire.

Combien coutent vraiment les frais ?

Comptez 1,5 a 2 % en collection selon votre volume negocie. Sur un volume mensuel eleve, le taux se rapproche de 1,5 %. Integrez toujours ce cout dans votre marge, pas dans le prix affiche.

Le sandbox est-il fiable pour tester ?

Le sandbox Airtel reproduit le flux OAuth, collection et callback avec des numeros de test. Il ne simule pas parfaitement les pertes reseau, donc gardez une logique de query status robuste en production.

Discutons de votre projet. Nous integrons Airtel Money, M-Pesa et les wallets locaux sur votre checkout, testes de bout en bout. WhatsApp +221 77 596 93 33.

Tags :#airtel money#tanzanie#zambie#api paiement#collection#disbursement
Partager :

Mohamed Bah

Fondateur, Kolonell

Passionné par le digital et l'entrepreneuriat en Afrique, Mohamed accompagne les entreprises sénégalaises dans leur transformation digitale depuis 2020. Fondateur de Kolonell, il croit que chaque PME mérite une présence en ligne professionnelle et accessible.