KODA
Blog KODA

L'API de vérification mobile money (3 endpoints)

Ajoutez des contrôles anti-fraude à toute application. L'API de vérification mobile money de KODA crée une intention, vérifie une référence et déclenche un webhook.

Read in English →

— lectures

Si vous construisez un paiement en ligne, une place de marché ou toute application qui accepte le mobile money, vous savez déjà que le plus dur n'est pas d'accepter le paiement — c'est de prouver que le paiement a réellement eu lieu. Les opérateurs rendent leurs propres API de confirmation lentes, coûteuses ou tout simplement inaccessibles aux petites entreprises. KODA vous donne la couche de vérification qu'ils rendent si difficile à obtenir, exposée sous la forme d'une API de vérification mobile money nette que vous pouvez intégrer en un seul après-midi.

La surface d'exposition est volontairement réduite. Il y a trois endpoints de base : créer une intention de paiement, vérifier la référence d'un client par rapport à la confirmation de l'opérateur, et consulter votre usage. Autour d'eux se trouve un bac à sable avec des codes de test magiques, pour que vous puissiez construire et tester tout le flux sans qu'un seul franc ne change de mains. Les détails complets des requêtes et des réponses se trouvent sur la page KODA API for developers, mais la structure est assez simple pour tenir dans votre tête.

Un flux typique ressemble à ceci. Votre serveur crée une intention pour, disons, 25 000 CDF et indique au client où payer. Le client envoie l'argent via son opérateur et soumet le code de référence qu'il a reçu. Votre serveur appelle la vérification avec ce code, et KODA le compare au SMS de confirmation propre de l'opérateur présent sur le téléphone du marchand. En trois secondes environ, vous recevez un verdict définitif — confirmé ou non.

Le point le plus important au sujet de cette API, c'est ce qu'elle n'exige pas. Il n'y a aucune intégration télécom, aucun contrat d'opérateur et aucune approbation de partenariat à attendre. KODA vérifie par rapport au SMS de confirmation plutôt que par un endpoint d'opérateur, et c'est pourquoi vous pouvez éviter tout le processus pénible décrit dans How to Verify an M-Pesa Payment Without a Telco API. Vous obtenez une certitude de niveau opérateur sans jamais toucher à la paperasse d'un opérateur.

La sécurité est intégrée à l'étape de vérification, pas rajoutée après coup. Une fois qu'une référence est confirmée, KODA la verrouille pour toujours. Cette protection anti-rejeu à usage unique est ce qui empêche un client de réutiliser une confirmation valide sur plusieurs commandes, et c'est l'épine dorsale de la défense contre How to Stop Mobile Money Screenshot Fraud in 2026. L'anti-falsification, le scoring de fraude et les règles de vélocité s'exécutent à chaque appel, de sorte qu'une rafale de vérifications suspectes est signalée automatiquement.

Vous ne devriez jamais interroger KODA en boucle en attendant qu'un paiement aboutisse. Enregistrez plutôt un webhook, et KODA pousse un événement signé à l'instant où une référence se vérifie — depuis n'importe quelle porte, pas seulement l'API. Ce schéma en temps réel est traité dans Get a Webhook the Moment a Payment Is Verified, et c'est lui qui permet à une commande de se confirmer et de s'expédier toute seule, sans qu'un humain ne rafraîchisse un tableau de bord.

Si vous préférez ne pas construire le front-end du tout, il existe une option prête à l'emploi. Le Checkout hébergé vous donne une page de paiement toute faite qui dialogue avec le même moteur, de sorte que vous pouvez ajouter du mobile money vérifié à un site avec presque aucun code — expliqué pas à pas dans Add a Verified Mobile Money Checkout to Any Website. Beaucoup d'équipes démarrent avec le Checkout pour lancer vite, puis passent à l'API brute à mesure que leurs besoins grandissent.

Une erreur d'intégration fréquente est de considérer le code de référence comme fiable dès l'instant où le client le tape, ou de le stocker sans imposer l'usage unique dans votre propre base de données. Avec KODA, vous ne portez pas ce fardeau — le verrou vit dans le moteur, de sorte que même si le même code est soumis depuis deux appareils à la fois, une seule commande pourra jamais le revendiquer. Laissez la plateforme s'occuper de l'unicité au lieu de la réinventer dans votre schéma.

L'API n'est tout simplement que l'une des Five Ways to Accept & Verify Mobile Money (One Engine), partageant son moteur avec la Console, WhatsApp, l'USSD et le SMS entrant. Cela signifie qu'un paiement que votre API vérifie et un paiement qu'un caissier contrôle à la main atterrissent dans exactement le même registre verrouillé, avec les mêmes contrôles anti-fraude appliqués. Tout ce dont vous avez besoin — endpoints, signature des webhooks et clés de bac à sable — est documenté sur la page KODA API for developers.

Commencez petit et développez-vous progressivement. Beaucoup d'équipes livrent leur première version en n'utilisant que la création d'intention et la vérification, prouvent que le flux fonctionne avec les codes magiques du bac à sable, puis ajoutent les webhooks et le reporting d'usage une fois que de vraies commandes affluent. Comme aucun contrat d'opérateur ne conditionne quoi que ce soit, vous n'êtes jamais bloqué à attendre qu'un tiers approuve votre lancement. Get started with KODA free et récupérez une clé de test pour développer dès aujourd'hui. La version anglaise est The Mobile Money Verification API (3 Endpoints, No Telco Deal).

Questions fréquentes

Que fait l'API KODA ?

Elle crée une intention de paiement, vérifie le code de référence d'un client par rapport au SMS de l'opérateur, et notifie votre serveur via un webhook. Référence complète sur KODA API for developers.

Ai-je besoin d'une API d'opérateur pour l'utiliser ?

Non — c'est tout l'intérêt. KODA vérifie par rapport au SMS de confirmation, vous évitez donc entièrement le processus télécom décrit dans How to Verify an M-Pesa Payment Without a Telco API.

À lire aussi

Vérifiez votre premier paiement gratuitement → · ← tous les articles