API, webhook : de quoi parle-t-on ?
Deux mots reviennent dans tout projet d’intégration. Ils sont plus simples qu’il n’y paraît.
-
L’API
Une API est une porte d’entrée sécurisée qu’un logiciel ouvre aux autres : votre site s’en sert pour demander un paiement, votre CRM pour créer une facture. Chaque appel est authentifié par une clé secrète.
-
Le webhook
Un webhook est un message qu’un service envoie automatiquement à votre serveur quand un événement se produit, par exemple « paiement réussi ». Au lieu de demander sans cesse si c’est payé, votre système est prévenu au bon moment.
Mobile Money : agrégateur de paiement ou API directe de l’opérateur ?
En Côte d’Ivoire, vos clients paient avec Orange Money, MTN MoMo, Moov Money ou Wave. Il existe deux façons de les accepter.
L’agrégateur de paiement
Un prestataire regroupe plusieurs opérateurs derrière une seule intégration ; beaucoup proposent aussi la carte bancaire. CinetPay et Flutterwave, par exemple, acceptent les moyens de paiement mobile ivoiriens. Un contrat, un tableau de bord, un format de notification : c’est la voie la plus rapide pour la plupart des sites et applications.
L’API directe d’un opérateur
Vous signez avec chaque opérateur et intégrez son API. Plus de démarches et une intégration par opérateur, mais une relation directe, utile quand vos volumes permettent de négocier ou quand un opérateur domine votre clientèle.
| Critère | Agrégateur de paiement | API directe d’un opérateur |
|---|---|---|
| Opérateurs couverts | Plusieurs, avec une seule intégration | Un seul par intégration |
| Démarches | Un contrat et un compte marchand | Un contrat par opérateur |
| Mise en place | Plus courte | Plus longue, opérateur par opérateur |
| Frais | Variables, à négocier avec le prestataire | Variables, à négocier avec chaque opérateur |
| Notifications et rapports | Un format unique | Un format par opérateur |
| Pour qui | La plupart des sites, boutiques et applications | Gros volumes, opérateur dominant, besoin spécifique |
Frais et conditions changent souvent : à vérifier auprès de chaque prestataire au moment du projet.
Pour le détail pas à pas, lisez notre guide accepter Orange Money, MTN MoMo et Wave sur un site web. Vous lancez une boutique ? Voyez aussi notre page site e-commerce à Abidjan.
Paiements en attente, échoués ou remboursés : comment ne rien perdre ?
Avec le Mobile Money, le client valide le paiement sur son téléphone, pas toujours immédiatement, parfois jamais. Votre système doit traiter chaque cas, sans livrer une commande impayée ni valider deux fois le même paiement.
| Statut | Ce qui se passe | Ce que fait votre système |
|---|---|---|
| En attente | Le client n’a pas encore validé sur son téléphone | Commande réservée sans être confirmée ; vérification automatique auprès du prestataire |
| Réussi | Le prestataire confirme par webhook | Avis authentifié, commande validée, reçu par SMS ou WhatsApp, écriture préparée |
| Échoué ou expiré | Solde insuffisant, refus, délai dépassé | Commande libérée, client invité à réessayer |
| Remboursé | Annulation ou retour | Remboursement tracé, avoir et écriture correspondants |
| Avis en double | La même notification arrive deux fois | Ignoré grâce à un identifiant unique : pas de double validation |
Comment rapprocher les paiements de votre comptabilité ?
Un paiement encaissé doit se retrouver, au franc près, dans votre comptabilité. Nous automatisons le chemin complet.
- Chaque paiement porte la référence de la commande ou de la facture.
- Un paiement réussi marque la facture comme payée et prépare l’écriture comptable.
- Les versements du prestataire, frais éventuels déduits, sont rapprochés des paiements individuels.
- Les écarts apparaissent dans un tableau de bord, au lieu d’être découverts en fin de mois.
Pour une entreprise qui encaisse beaucoup de petits montants, c’est souvent là que se cachent les heures perdues.
Relier CRM, facturation et messagerie : que peut-on automatiser ?
Vos outils sont souvent bons, mais ils ne se parlent pas : on recopie un contact, on ressaisit une facture, on transfère un message. Quelques liaisons typiques :
-
CRM
Un formulaire du site ou un message WhatsApp crée le contact et l’opportunité dans HubSpot ou Salesforce, avec la source de la demande.
-
Facturation
Un devis accepté devient une facture, la facture payée met à jour le CRM, et le client reçoit son reçu automatiquement.
-
WhatsApp
Confirmations de commande, rappels de rendez-vous ou de paiement partent de vos outils. Ces envois passent par la plateforme WhatsApp Business, facturée par Meta au message : grille à vérifier au moment du projet.
-
Slack et Teams
Une alerte dans le bon canal quand un paiement important arrive, quand un stock passe sous le seuil ou quand un client clé écrit.
-
Google Workspace
Gmail, Sheets, Drive et Calendar reliés à vos logiciels : un tableau de suivi qui se remplit seul, des rendez-vous créés automatiquement, des documents rangés au bon endroit.
-
Microsoft 365
Outlook, Excel et Teams connectés de la même façon, pour les entreprises qui travaillent dans l’environnement Microsoft.
Quand l’enchaînement demande des décisions, comme trier une demande ou rédiger une relance, nous passons aux automatisations et agents IA, avec n8n ou Make.
Comment migrer vos données sans ressaisie ?
Changer d’outil ne doit pas vouloir dire tout recopier. Nous extrayons les données de l’ancien système (export, base de données ou fichiers), les convertissons au format du nouvel outil, puis les importons par programme, avec des contrôles de totaux et de soldes. Un essai sur une copie précède la migration définitive, et l’ancien outil reste consultable pendant la transition.
Exemple : lors d’une mission de reprise comptable, nous avons reconstruit plusieurs années d’écritures issues de logiciels propriétaires, sans ressaisie. Si la migration accompagne un nouvel outil construit pour vous, voyez notre page logiciel et application web sur mesure.
Comment sécuriser une intégration de paiement ?
-
Des clés jamais exposées
Les clés d’API restent sur le serveur, stockées chiffrées, jamais dans le code du site ou de l’application. Ouvertes à votre nom, elles peuvent être renouvelées à tout moment.
-
Des avis authentifiés
Chaque webhook est vérifié (signature ou contrôle auprès du prestataire) avant de valider quoi que ce soit : un faux avis « payé » ne passe pas.
-
Des montants calculés par le serveur
Le montant à payer est toujours recalculé par votre serveur, jamais repris tel quel depuis le navigateur ou l’application.
-
Des journaux complets
Chaque appel et chaque notification sont journalisés : en cas de litige, vous retrouvez qui a payé quoi, quand et par quel canal.
Comment se déroule un projet d’intégration ?
-
Cadrage
Inventaire de vos outils et de vos flux d’argent et de données, choix entre agrégateur et API directe, planning et devis ferme, détaillé par étape.
-
Conception
Schéma des échanges, statuts de paiement, règles de rapprochement et plan de reprise des données, validés avec vous avant le code.
-
Développement
Intégration dans l’environnement de test du prestataire quand il en propose un, échecs et doublons simulés, livraisons courtes sur un environnement de test accessible.
-
Mise en ligne
Passage en production avec vos clés, premiers paiements surveillés, reprise des données et formation de votre équipe.
-
Croissance
Supervision, suivi des évolutions des API des prestataires, nouveaux moyens de paiement et nouvelles automatisations.
Pourquoi confier vos intégrations à Jingi Agency ?
-
Le Mobile Money dans un vrai produit
Madata, l’ERP des PME d’Afrique francophone que nous avons conçu et développé, intègre le paiement Mobile Money, sur le web, iPhone et Android. Lire l’étude de cas Madata.
-
Paiement et SMS en mission
Pour un groupe d’assurance et de services, nous avons mis en place un portail client avec cotations en ligne, des caisses multi-sociétés, le paiement Mobile Money et des SMS automatiques.
-
Des données reprises sans ressaisie
Plusieurs années d’écritures comptables reconstruites depuis des logiciels propriétaires, et une plateforme multi-clients mise à jour sans interruption de service.
-
Vos comptes, vos outils
Comptes marchands, clés d’API et accès sont à votre nom. Nous travaillons dans vos outils (WhatsApp, Slack, Teams), avec un seul interlocuteur : Félix de La Boissière, fondateur de Jingi Agency.
Questions fréquentes sur l’intégration Mobile Money et API
Comment accepter Orange Money, MTN MoMo, Moov Money et Wave sur un site web ?
Le plus simple est de passer par un agrégateur de paiement, qui regroupe ces opérateurs derrière une seule intégration. Votre site crée la demande de paiement, le client valide sur son téléphone, puis le prestataire confirme le résultat par un webhook. La commande n’est validée qu’après cette confirmation vérifiée. L’API directe d’un opérateur reste possible pour les gros volumes.
Faut-il choisir un agrégateur ou l’API directe d’un opérateur ?
Un agrégateur convient à la plupart des entreprises : une seule intégration, un seul contrat et un seul tableau de bord pour plusieurs opérateurs. L’API directe demande un contrat et une intégration par opérateur ; elle se justifie quand les volumes permettent de négocier ou quand un opérateur domine votre clientèle. Dans les deux cas, les frais sont à vérifier auprès du prestataire.
Que se passe-t-il si un paiement Mobile Money reste en attente ?
La commande est réservée mais pas confirmée. Votre système interroge le prestataire à intervalles réguliers et attend son avis. Si le client valide, la commande passe en payée et il reçoit son reçu ; si le délai expire ou si le paiement échoue, la commande est libérée et le client est invité à réessayer. Rien n’est livré sans confirmation.
Qu’est-ce qu’un webhook ?
Un webhook est un message envoyé automatiquement par un service à votre serveur dès qu’un événement se produit, par exemple un paiement réussi. Votre système n’a pas besoin de demander sans cesse si c’est payé : il est prévenu au bon moment. Chaque webhook doit être authentifié avant d’être pris en compte, pour qu’un faux avis de paiement ne puisse pas valider une commande.
Pouvez-vous relier notre CRM, notre facturation et WhatsApp ?
Oui. Une demande reçue sur le site ou sur WhatsApp peut créer le contact dans votre CRM, un devis accepté devenir une facture, et une facture payée déclencher un reçu et une alerte dans Slack ou Teams. Nous travaillons avec HubSpot, Salesforce, Google Workspace, Microsoft 365, Notion, Stripe ou PayPal, et créons une API sur mesure quand l’outil l’exige.
Comment migrer nos données d’un ancien logiciel sans tout ressaisir ?
Nous partons d’un export ou d’un accès à l’ancienne base, faisons correspondre chaque champ avec le nouvel outil (contacts, articles, factures, historiques), puis importons par programme. Un premier essai sur une copie permet de mesurer les écarts avant la migration définitive. La même méthode nous a permis de reconstruire plusieurs années d’écritures comptables issues de logiciels propriétaires, sans ressaisie.
Comment sont protégées les clés d’API et les données de paiement ?
Les clés d’API restent sur le serveur, stockées chiffrées, jamais dans le code du site ou de l’application. Chaque webhook est authentifié, les montants sont recalculés côté serveur et chaque échange est journalisé. Les comptes marchands et les clés sont ouverts à votre nom : vous pouvez les renouveler ou retirer un accès à tout moment.