Skip to main content

​
Couples disponibles

Un couple pays / opérateur inexistant est refusé en 422 UNSUPPORTED_OPERATOR, sans aller-retour réseau.
La devise est déterminée par le pays : vous n’avez pas à la transmettre. Elle est renvoyée dans operation.currency.

​
Pays ouverts sur votre compte

Tous les pays de ce tableau ne sont pas nécessairement ouverts sur votre compte. Par défaut, seul votre pays d’établissement l’est.
Un pays hors de cette liste est refusé en 422 UNSUPPORTED_COUNTRY, avec details.allowedCountries. L’ouverture d’un nouveau corridor se demande à votre référent Djonanko.

​
Montants

Aucune devise servie n’a de sous-unité. Le XOF, le XAF et le GNF s’expriment en unités entières : 5000 vaut 5 000 FCFA.Tous les montants de l’API sont des entiers. 5000.50 est refusé en 400 VALIDATION_ERROR. N’utilisez pas de type flottant dans votre code : un arrondi de centime produit des écarts dont l’origine devient introuvable.

​
Formats de numéro acceptés

Les trois formes suivantes sont équivalentes et normalisées en E.164 :
Le numéro est renvoyé normalisé dans operation.counterparty.phoneNumber :

​
Longueurs attendues par pays

Un numéro hors de ces longueurs est refusé en 422 INVALID_PHONE_NUMBER, avec details.expectedLengths.
En Côte d’Ivoire, les numéros à dix chiffres commencent par 0 et ce zéro fait partie du numéro. Ne le retirez pas avant de nous le transmettre : envoyez-le tel que votre client vous l’a donné, nous le normalisons.

​
Comportement du payeur selon l’opérateur

Ne codez pas en dur cette répartition : testez le champ requiresPayerAction de la réponse. Le comportement d’un opérateur peut évoluer, et votre intégration doit suivre sans redéploiement.
Sur un transfert, aucune action n’est jamais attendue du bénéficiaire : son compte est crédité directement.