Prestataires et canaux
Les canaux qu'un payout peut utiliser et les conditions qui déterminent leur disponibilité.
Un canal désigne un opérateur dans un pays : cm.mtn correspond à MTN Cameroun et sn.wave à
Wave Sénégal. Il appartient au bénéficiaire et reste donc fixé dès la création de la destination ;
la liste ci-dessous indique ce que l'API accepte, et l'exécution réelle dépend de votre compte.
Conditions à remplir
Un canal de la liste ci-dessous est accepté lorsque vous l'indiquez, mais un payout ne s'exécute que sur un canal sur lequel votre compte peut effectuer des payouts, dans cette devise.
| Cas | Refus avec |
|---|---|
| Le slug n'est pas un canal de payout | 422 The selected beneficiary.channel is invalid. |
| Votre compte n'a aucune route de payout pour ce canal et cette devise | 422 No payout provider is available for this channel and currency. |
Canaux acceptés par l'API
L'API accepte cinquante canaux Mobile Money dans vingt-deux pays. Chacun constitue une valeur
valide pour beneficiary.channel.
| Pays | Canaux |
|---|---|
 Bénin | bj.mtn bj.moov |
 Burkina Faso | bf.orange bf.moov |
 Cameroun | cm.mtn cm.orange cm.eu |
 Congo-Brazzaville | cg.mtn cg.airtel |
 Côte d'Ivoire | ci.mtn ci.orange ci.moov ci.wave |
 RD Congo | cd.vodacom cd.airtel cd.orange cd.africell |
 Égypte | eg.vodafone |
 Gabon | ga.airtel ga.moov |
 Ghana | gh.mtn gh.vodafone gh.airteltigo |
 Guinée | gn.mtn gn.orange |
 Kenya | ke.mpesa ke.airtel |
 Liberia | lr.mtn |
 Malawi | mw.airtel mw.tnm |
 Mali | ml.orange ml.moov |
 Mozambique | mz.mpesa |
 Rwanda | rw.mtn rw.airtel |
 Sénégal | sn.orange sn.free sn.wave |
 Sierra Leone | sl.orange |
 Tanzanie | tz.mpesa tz.airtel tz.tigo tz.halopesa |
 Togo | tg.tmoney tg.moov |
 Ouganda | ug.mtn ug.airtel |
 Zambie | zm.mtn zm.airtel zm.zamtel |
cd.vodacom et mz.mpesa désignent tous deux M-Pesa, tandis que cm.eu désigne Express Union.
Trois autres canaux sont valides pour un bénéficiaire sans être du Mobile Money : ci.djamo et
sn.djamo, des portefeuilles Djamo payés par numéro de téléphone, et wajub, un autre compte Wajub
payé par son numéro de compte, qui ne quitte jamais Wajub et n'entraîne aucuns frais.
Tout autre canal, bancaire compris, renvoie 422 The selected beneficiary.channel is invalid. Une
destination bancaire est un compte de versement que vous
créez dans le Dashboard sur le canal wire.
Canal générique
Un payout désigne son canal : le slug de l'opérateur dans ce tableau, comme ke.mpesa ou
eg.vodafone. Il n'y a qu'une exception, le Cameroun : cm.mobile détermine à partir du numéro s'il
s'agit de cm.mtn ou de cm.orange. La page Bénéficiaires explique le
fonctionnement de cette résolution et ses cas d'échec.
Aucun autre pays n'a de canal générique. ke.mobile, eg.mobile ou tout autre {country}.mobile
est refusé comme un canal inconnu, avec 422 et The selected channel is invalid.. Même au
Cameroun, indiquez l'opérateur dès que vous le connaissez : un échec de résolution produit une
erreur 422, alors qu'un slug explicite serait passé directement.
Couverture propre à votre compte
Tous les canaux autres que cm.mtn, cm.orange et cm.eu nécessitent un prestataire de payout
connecté à votre compte et approuvé par Wajub pour les payouts live ;
GET /providers liste ce que possède votre compte. Connecter un prestataire
pour les encaissements n'active pas son côté payout.
Par défaut, trois canaux effectuent des payouts
Tant qu'aucun prestataire de payout n'est approuvé sur votre compte, les payouts live partent
uniquement sur cm.mtn, cm.orange et cm.eu. Vérifiez ce point avant d'intégrer un corridor à
votre produit, plutôt que de le découvrir lors du premier transfert live.
Ce que la devise détermine ou non
Envoyez la devise de règlement de l'opérateur : XAF sur cm.*, XOF sur ci.*. Une devise dans
laquelle votre compte ne peut pas effectuer de payout sur ce canal renvoie le même message
No payout provider is available for this channel and currency. que tout autre manque de
couverture.
Prestataire chargé du payout
Un transfert ne possède aucun champ provider ni aucune surcharge par appel : vous indiquez un
canal. Lorsque plusieurs prestataires de payout connectés à votre compte peuvent le traiter, la
priorité que vous définissez pour chacun détermine l'ordre, et un échec fait passer au suivant. La
page Orchestration explique comment définir cette priorité.
Le transfert indique ensuite dans provider le prestataire qui l'a exécuté. L'identifiant propre à
l'opérateur apparaît dans provider_reference une fois que le payout l'a atteint.