Cycle de vie des paiements et reversements
Comment les statuts encaissement et décaissement s’articulent, liens vers la machine à états, soldes et webhooks.
Cette page est la carte marchande des statuts de paiement et de reversement. Pour les tableaux de transition et diagrammes complets, voir Machine à états du paiement.
Encaissement
| Phase | Statut typique | Impact pour vous |
|---|---|---|
| Le client commence | pending | UI en attente ; ne pas livrer |
| Confirmation prestataire | completed | Crédit solde test/live ; livrer après vérification |
| Délai / abandon | failed ou expired | Libérer le stock ; proposer une nouvelle tentative |
| Remboursement | refunded | Annuler la livraison si besoin |
Test vs live : les clés test complètent souvent le mobile money immédiatement ; en live le statut reste pending jusqu’à approbation sur l’appareil.
Décaissement (reversements et remboursements)
Les reversements passent par pending → processing → completed ou failed. Considérez completed comme « fonds sortis de la plateforme ».
Retraits vs bénéficiaires
- Retraits : fonds de votre solde lomi. vers vos propres moyens (mobile money, banque, etc.).
- Virements vers bénéficiaires : fonds envoyés vers un compte tiers (prestataires, partenaires, routage des remboursements).
Certains flux valident le solde à la création et débitent ou finalisent à la complétion. Un virement peut être accepté tout en étant encore en cours. Si le solde évolue avant le règlement, la complétion peut échouer.
Frais et plafonds
Les frais dépendent de la configuration tarifaire de l’organisation, du prestataire et du moyen (banque locale vs internationale), et de la devise. Les retraits peuvent imposer des montants min/max et des caps par période. Voir Tarification marchand d’enregistrement.
Échecs
Les échecs peuvent venir de coordonnées invalides, d’un refus prestataire ou d’un solde insuffisant au règlement. Consultez le statut dans l’API. Voir Virements et Remboursements.
Soldes et règlement
Les paiements completed mettent à jour votre solde marchand selon les frais et délais de disponibilité. Voir Solde et règlement.
Les webhooks relient tout
Voir aussi
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.
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.