Solde et règlement
Fonctionnement des soldes marchands, des frais et de la disponibilité des fonds après un paiement réussi.
Les soldes sont mis à jour lorsqu’une transaction passe en completed. Cette page décrit le modèle implémenté dans la logique de mise à jour des soldes (y compris la normalisation XOF pour la trésorerie).
Quand les soldes changent
- Le solde net dû au marchand augmente du montant net de la transaction (brut moins frais de plateforme).
- Les mises à jour ne s’appliquent qu’aux transactions
completed. - Un indicateur en métadonnée indique quand les soldes ont déjà été appliqués pour cette transaction, afin qu’une nouvelle tentative ne crédite pas deux fois.
Délai de disponibilité
Chaque transaction enregistre un horodatage available_at calculé à partir des paramètres de paiement de l’organisation :
NOW() + get_payment_availability_delay(organization, provider, payment_method);- exemple : certaines configurations carte imposent une fenêtre différée avant disponibilité ; Mobile Money peut être immédiat.
Le tableau de bord peut distinguer montants disponibles et en attente / en cours de compensation selon ces règles.
Devise et trésorerie XOF
La traçabilité interne normalise souvent les montants en XOF :
- montants bruts et frais peuvent être convertis pour la comptabilité canal et plateforme ;
- le crédit sur compte marchand peut rester dans la devise de règlement de l’organisation selon les réglages ; l’important est que frais et floats partagent une base cohérente.
Les champs API « disponible » vs « en attente » figurent sur Comptes et indicateurs associés.
Coupons et complétion
Les compteurs de coupons évoluent en général lorsque la transaction est complétée, pas au moment où le coupon est simplement saisi au tunnel.