Le franc CFA (XOF, XAF) n'a pas de sous-unité. 5 000 XOF est 5 000, pas 50,00. Le yen japonais (JPY) fonctionne pareil. Mais la plupart des API de paiement, suivant la convention de Stripe, attendent les montants dans la plus petite unité monétaire : 5,00 USD = 500 centimes. Pour le XOF, la plus petite unité EST 1 XOF, donc 5 000 XOF = 5000.
Les bugs que nous avons trouvés
Plusieurs bugs de précision ont été découverts dans les premières sessions :
- Affichage double division : 5 000 XOF affiché comme 50,00 XOF (le code divisait par 100 alors qu'il ne fallait pas).
- Flottants en base de données : stocker les montants en float plutôt qu'en integer causait des erreurs d'arrondi.
- Conversion Stripe : envoyer 5000 à Stripe pour du XOF fonctionne, mais envoyer 5000 pour du USD crée un débit de 50,00 $.
La solution : int(round())
Tous les montants sont stockés en tant qu'entiers dans la plus petite unité de la devise. L'affichage utilise une table de devises qui indique le nombre de décimales (0 pour XOF/JPY, 2 pour USD/EUR). int(round(amount)) est appliqué à chaque calcul pour éliminer les erreurs de flottants.
Cet article fait partie de la série « Comment nous avons construit 0fee.dev ». 0fee.dev est un orchestrateur de paiement couvrant 53+ fournisseurs dans 200+ pays, construit par Juste Thales Gnimavo et Claude depuis Abidjan sans aucun ingénieur humain. Suivez la série pour l'histoire complète de la construction.