Soldes et frais
Solde disponible par opérateur, calcul des frais et mouvements.
GET /v1/merchant/account et /v1/merchant/balance retournent available_minor, gross_collected_minor, fees_minor, transferred_minor et by_operator pour les opérateurs que le marchand peut lire. Le montant global est la somme de ces soldes opérateurs.
GET /v1/merchant/movements?page=1&page_size=25 retourne chaque mouvement confirmé avec amount_minor, fee_minor, delta_minor, balance_before_minor et balance_after_minor.
L’admin configure les taux de collecte et de transfert par marchand/opérateur. Les taux sont en points de base : 150 = 1,5 %, 200 = 2 %. Le taux applicable est figé à la création de chaque collecte. Les frais sont arrondis à l’unité XOF (demi-unité vers le haut). Après réussite, net = brut - frais est crédité. Les collectes en attente ou échouées ne créditent pas le solde.
Les frais de transfert sont configurables, mais aucun endpoint d’exécution de transfert n’est encore public. transferred_minor reste à zéro jusqu’à l’implémentation d’un flux de payout vérifié.