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.
Recette webhook n8n : vérifier X-Lomi-Signature dans n8n et envoyer WhatsApp ou e-mail.
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é.

Recette webhook n8n

Recevoir un événement PAYMENT_SUCCEEDED signé dans n8n et envoyer une confirmation WhatsApp ou e-mail.

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 d’encaissement et de décaissement s’articulent, quand un paiement pending expire, et comment la complétion crédite votre solde.

Gestion des erreurs

Lors de l’intégration avec lomi., traitez les erreurs API pour que vos clients voient un résultat clair et que vos journaux restent utiles.

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.