Fiabilité
Webhooks, vérification des paiements, tests et pratiques opérationnelles pour une intégration sûre en production.
Ce dossier couvre la couche opérationnelle d’une intégration lomi. : recevoir les événements, confirmer les paiements, tester les cas d’échec.
- Traiter les webhooks : recevoir, vérifier et s’abonner aux événements.
- Fiabilité des webhooks : relances, doublons, délais et journaux de livraison.
- Vérifier les paiements : confirmer le statut via l’API et les webhooks, jamais via la seule redirection navigateur.
- Cycle de vie des paiements : comment les statuts encaissement et décaissement s’articulent.
- Tests : structurer les tests sandbox et production.
- Simuler les erreurs : matrice des scénarios (refus, Mobile Money en attente, échecs webhook).
Les identifiants et numéros de carte de test sont sur Paiements sandbox. Les codes d’erreur sont sur Erreurs.
Traiter les webhooks
Les webhooks fournissent des mises à jour en temps réel sur les événements de votre compte lomi. Ce guide explique comment recevoir et traiter ces notifications en toute sécurité.
Fiabilité des webhooks
Nouvelles tentatives, idempotence, journaux de livraison et traitement sûr des doublons.
Comment vérifier un paiement ?
Confirmez le statut côté serveur via l’API et les webhooks, ne vous fiez jamais à la seule redirection navigateur.
Cycle de vie des paiements et reversements
Comment les statuts encaissement et décaissement s’articulent, liens vers la machine à états, soldes et webhooks.
Gestion des erreurs
Lors de l’intégration avec lomi., il est essentiel de gérer les erreurs proprement afin d’offrir une expérience de paiement fluide à vos clients.
Clés d’idempotence
L’idempotence garantit qu’une requête API, en cas de nouvel essai après erreur réseau ou délai dépassé, ne soit pas appliquée plusieurs fois par inadvertance, essentiel pour les paiements ou remboursements afin d’éviter les doublons.
Bonnes pratiques de sécurité
Signaler une vulnérabilité, puis sécuriser les clés API, le TLS et la vérification des webhooks pour votre intégration lomi.
Guide des tests
Ce guide présente les bonnes pratiques pour tester votre intégration lomi. et garantir le bon fonctionnement des parcours de paiement en bac à sable et en production.
Comment simuler les erreurs ?
Testez refus, authentification 3DS, mobile money asynchrone et échecs webhook avant la mise en production.
CI/CD
Ce guide présente les bonnes pratiques pour intégrer lomi. à votre pipeline CI/CD, avec des déploiements fiables et des tests automatisés.
Solde et règlement
Fonctionnement des soldes marchands, des frais et de la disponibilité des fonds après un paiement réussi.
Traiter les webhooks
Les webhooks fournissent des mises à jour en temps réel sur les événements de votre compte lomi. Ce guide explique comment recevoir et traiter ces notifications en toute sécurité.