Statuts des paiements

Ce guide décrit le cycle de vie d'un paiement dans lomi., du pending au completed, en passant par l'échec ou l'expiration. Pour le code côté serveur, voir Pour les contributeurs.

Parcours d'un paiement

stateDiagram-v2
  [*] --> pending: paiement en production
  [*] --> completed: paiement test (sandbox)
  pending --> completed: confirmé par le prestataire
  pending --> failed: refus ou échec
  pending --> expired: délai dépassé
  completed --> refunded: remboursement
  failed --> [*]
  expired --> [*]
  refunded --> [*]

En test, un paiement est souvent completed tout de suite. En production, il reste en général pending jusqu'à ce que le client valide (mobile money, carte, etc.).

Les statuts

Côté prestataire (Wave, MTN, etc.)

Chaque statut transaction a un équivalent côté prestataire :

Voir Transactions pour les champs dans les réponses API.

Quand le statut passe à completed

• Un double webhook ne crédite pas le solde deux fois : lomi. fusionne les métadonnées et ne crédite qu'une fois.
• Les métadonnées s'ajoutent au fil des webhooks, elles ne sont pas écrasées.

Expiration

Un paiement pending peut expirer automatiquement :

• après un certain délai ;
• ou quand la session prestataire expire (ex. Wave).

L'info d'expiration est stockée dans expiration_info sur la transaction.

Effets d'un paiement réussi

1. Le coupon utilisé est comptabilisé.
2. Le solde est mis à jour (metadata.balance_updated évite un double crédit).
3. Un abonnement lié peut passer de pending à active.

Pour le délai de disponibilité des fonds, voir Solde et règlement.

Voir aussi

• Cycle de vie des paiements
• Vérifier les paiements
• Comportement du checkout
• Recevoir les webhooks