Skip to main content
Tous les montants de l’API sont des entiers en unités mineures : la plus petite unité que la devise permet de compter. C’est délibéré : les flottants arrondissent mal l’argent, un entier ne le peut pas. Vous n’envoyez donc jamais de décimales, mais le nombre de zéros à retirer dépend de la devise.

​
Nombre de décimales par devise

Pour convertir un montant lu par un humain, multipliez-le par 10 à la puissance du nombre de décimales : 10,50 USD s’envoie 1050, 5 000 XAF s’envoie 5000 tel quel puisque le XAF n’a pas de sous-unité.
N’envoyez jamais 5000.00 ou 10.50. Une valeur décimale est refusée par la validation de l’API.

​
Codes devise

Le code devise est un code ISO 4217 de trois lettres (XAF, USD, EUR, la casse n’importe pas : Mercy Pay normalise en majuscules). Un code qui n’existe pas dans la norme, comme ABC, est refusé net.

​
Minimums carte

En dessous d’un certain montant, le réseau carte lui-même refuse la transaction. Mercy Pay bloque donc la tentative en amont plutôt que de vous laisser découvrir l’échec après coup : Sous ce seuil, la page de paiement ne propose plus que le mobile money, et une tentative de paiement par carte échoue avec le minimum exprimé en unités que votre client comprend (pas en unités mineures).