Skip to main content
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

​
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

​
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.