Cycle de vie des virements
Comment les retraits et virements vers bénéficiaires évoluent de la demande à la clôture, et comment s’appliquent les frais.
Les virements impliquent contrôles de solde, frais, routage prestataire et statuts. Le comportement est réparti entre les fonctions base liées aux virements et à Wave ; cette page pose le cadre pour les intégrateurs.
Types de virement
- Retraits — fonds de votre solde lomi. vers vos propres moyens de paiement (Mobile Money, banque, etc.).
- Virements vers bénéficiaires — fonds envoyés vers un compte tiers (prestataires, partenaires, routage des remboursements, etc.).
Voir les références dédiées :
Progression des statuts
Les virements suivent des états tels que pending, processing, completed et failed (les énumérations exactes correspondent à votre schéma API).
Clôture vs initiation
Certains flux valident le solde à la création et débitent ou finalisent à la complétion. Donc :
- Un virement peut être accepté tout en étant encore en cours de traitement.
- Si le solde évolue avant le règlement final, la complétion peut échouer et le virement peut être marqué en échec ou annulé selon les règles du prestataire.
Considérez completed comme la référence pour savoir si les fonds ont quitté la plateforme.
Frais
Les frais de virement dépendent :
- de la configuration tarifaire de l’organisation (avec dérogations par paliers le cas échéant),
- du prestataire et du moyen de paiement (ex. banque locale vs internationale),
- de la devise.
La résolution des frais peut s’appuyer sur des helpers sensibles aux paliers. Pour une vue générale des modes de tarification, voir Organisations et Tarification marchand d’enregistrement.
Plafonds
Les retraits peuvent imposer des montants minimum / maximum et des caps par période (limites mensuelles par prestataire, par ex.). Les valeurs précises sont configurées par organisation et prestataire.
Échecs et nouvelles tentatives
Les échecs peuvent venir de coordonnées invalides, d’un refus prestataire ou d’un solde insuffisant au moment du règlement. Consultez le statut et les métadonnées du virement dans l’API et les journaux d’exploitation.