Fondamentaux
Ventilation des frais
Aucun frais n’est retenu en silence. Chaque commission est une écriture comptable distincte, et chaque opération expose son brut, ses frais, son net et le barème qui les a produits.
Les champs
Encaissements et reversements portent les mêmes champs. Ils valent null tant que l’opération n’est pas confirmée : les frais ne sont fixés qu’à l’issue.
| Champ | Ce qu’il contient |
|---|---|
amount_minor | Le brut : montant demandé au payeur, ou débité de votre solde pour un reversement. |
fee_minor | Les frais prélevés. |
net_minor | Brut moins frais : ce qui vous revient, ou ce que reçoit le bénéficiaire d’un reversement. |
fee_percent_bps | Le pourcentage appliqué, en points de base : 100 vaut 1 %. |
fee_fixed_minor | La part fixe appliquée. |
fee_min_minor | Le plancher appliqué, s’il y en a un. |
fee_max_minor | Le plafond appliqué, s’il y en a un. |
fee_source | catalog : la grille publique. negotiated : un tarif négocié pour votre compte. |
Le barème est estampillé sur l’opération : si la grille change demain, vous savez toujours pourquoi un paiement d’hier a coûté ce qu’il a coûté.
Le calcul
- Le brut multiplié par le pourcentage, arrondi à l’unité mineure la plus proche (une demi-unité s’arrondit vers le haut).
- Plus la part fixe.
- Relevé au plancher, puis ramené au plafond : le plafond a le dernier mot.
Les taux en vigueur sont ceux de la grille tarifaire, ou ceux de votre contrat s’ils ont été négociés. L’exemple ci-contre n’en est pas un.
Exemple de calcul
# Tarif hypothétique, pour illustrer le calcul : 1 % + 0 fixe
brut amount_minor 2500000 25 000,00 CDF
taux fee_percent_bps 100 1 %
fixe fee_fixed_minor 0
frais fee_minor 25000 arrondi(2500000 × 100 / 10000) + 0
net net_minor 2475000 2500000 - 25000Remboursements, reversements, relevés
- Remboursement : le payeur récupère la totalité du brut. Les frais de l’encaissement d’origine restent acquis.
- Reversement : votre solde est débité du brut, le bénéficiaire reçoit le net.
- Disponibilité : le net d’un encaissement mobile money est reversable dès sa confirmation ; celui d’un encaissement par carte, après le délai publié sur la page des tarifs. Pendant ce délai, il vous est dû mais reste « en attente » : un reversement qui le dépasse échoue avec
insufficient_funds, un remboursement peut y puiser. - Relevé :
GET /v1/reports/summaryadditionne brut, frais et net des encaissements réussis sur une période, devise par devise.