Passer au contenu principal
Payfonte attend les valeurs amount dans la plus petite dénomination de la devise, c’est-à-dire la sous-unité. Utilisez la règle suivante : amount_to_send = major_amount * 100 Exemple : 100.50 NGN devient 10050.
N’envoyez pas de valeurs décimales dans les requêtes API. Envoyez toujours des montants entiers.

​
Pourquoi ce format ?

Précision

Évite les problèmes d’arrondi à virgule flottante dans les calculs financiers.

Cohérence

Même format de montant pour les collectes, décaissements et portefeuilles.

Alignement provider

Correspond à la façon dont les providers de paiement traitent les valeurs en interne.

​
Tableau rapide de conversion

DeviseUnité principaleSous-unitéExemple
NGNNairaKobo100.00 NGN -> 10000
GHSCediPesewa50.00 GHS -> 5000
KESShillingCent100.00 KES -> 10000
XOFFranc CFASous-unité10.00 XOF -> 1000
USDDollarCent25.99 USD -> 2599

​
Exemples API

Les exemples ci-dessous montrent la même règle dans des requêtes réelles :
  • 1250.75 NGN s’envoie sous la forme 125075, en kobo
  • 10000.00 NGN s’envoie sous la forme 1000000, en kobo
{
  "currency": "NGN",
  "amount": 125075,
  "reference": "ORDER-1001"
}

​
Erreurs fréquentes

Envoi de montants décimaux

  • Incorrect : "amount": 1250.75
  • Correct : "amount": 125075
N’envoyez pas certaines requêtes en unités principales et d’autres en sous-unités. Standardisez la conversion dans un utilitaire partagé.
La logique de conversion doit s’exécuter côté backend pour rester contrôlée et cohérente.

​
Schéma d’implémentation recommandé

1

Stocker les montants métier comme décimaux ou chaînes

Gardez vos montants lisibles pour l’affichage et la logique métier, par exemple 1250.75.
2

Convertir juste avant la requête API

Convertissez en entier de sous-unité, comme 125075, à la frontière de votre service.
3

Journaliser les deux valeurs

Loguez displayAmount et apiAmount pour simplifier le débogage et le rapprochement.

​
Documentation associée

Autorisation

Ajoutez les en-têtes d’authentification requis à vos requêtes.

Portefeuilles

Comprendre les soldes et états de portefeuille.

Référence API

Explorez les schémas de requête et de réponse.