Documentation neo-pays
L'API d'encaissement et de versement de neo-pays : mobile money, virement sur IBAN dédié et paiement instantané BCEAO, derrière une seule intégration.
Commencer
- Démarrage rapide — du compte au premier encaissement
- Authentification — clés, mode test, idempotence
- Référence API — toutes les opérations, générée depuis la spécification
Les guides
| Guide | Ce qu'il couvre |
|---|---|
| Encaissements | Créer un paiement, le lire, le suivre |
| Versements | Envoyer des fonds, et le solde qui les gouverne |
| Remboursements | Rendre tout ou partie d'un encaissement |
| Statuts | Le cycle de vie d'une opération |
| Webhooks | Signature, relivraison, déduplication |
| Erreurs | L'enveloppe et ce que chaque code demande de faire |
Trois choses à savoir avant d'écrire du code
Les montants sont en unités mineures, en chaîne de caractères. "amount_minor": "500000" avec
un actif à zéro décimale vaut 500 000. Jamais un nombre à virgule flottante, jamais un entier JSON :
les deux perdent des centimes. Le nombre de décimales de chaque actif est donné par
GET /v1/assets — ne le codez pas en dur.
Les actifs et les plateformes sont des identifiants, pas des symboles. Vous envoyez asset_id
et platform_id, pas "XOF" et "orange_money". GET /v1/corridors dit lesquels votre compte
peut emprunter, dans l'ordre où le routage les choisirait.
Il n'y a pas de conversion de devise. Les montants ne s'additionnent jamais entre actifs, et aucun appel n'en convertit un en un autre.
Une seule version
L'API est /v1, et c'est la seule. La couche de compatibilité haybtech qui occupait ce chemin a été
supprimée le 12/09/2026 — rien n'avait jamais été livré dessus — et la surface neo-pays, jusque-là
montée sur /v2, a pris sa place. Si vous croisez une référence à /v2, elle est périmée.