Passerelles prises en charge
Cartflox n’encaisse pas à votre place : vous connectez vos propres comptes agrégateurs dans Passerelles, et chaque paiement arrive directement chez eux. Cette page liste ce qui est pris en charge et comment votre client paie selon la passerelle.
Connecter une passerelle
Section intitulée « Connecter une passerelle »- Dans Passerelles, choisissez la carte de l’agrégateur, puis Connecter.
- Collez les clés de votre compte agrégateur. Le bouton Vérifier interroge l’agrégateur immédiatement : une clé refusée n’est jamais enregistrée.
- Activez ensuite ses moyens de paiement dans Moyens de paiement.
Certains agrégateurs ouvrent un compte marchand par pays : Hub2 et Djamo Business se connectent donc pays par pays, avec les identifiants de ce pays sur chaque carte (« Hub2 Côte d’Ivoire », « Hub2 Sénégal »…).
Où se passe le paiement
Section intitulée « Où se passe le paiement »Sauf mention contraire, votre client reste sur la page de paiement Cartflox (ou dans votre page avec SoftPay) : la demande est poussée sur son téléphone, il la confirme avec son code secret, et la page se met à jour toute seule. Trois autres cas existent :
- Code de confirmation : certains opérateurs exigent un code (Orange Money, Magma OnePay, Paystack Ghana et Kenya). Il se saisit sur la page.
- Lien d’application (Wave Business, Djamo) : ces fournisseurs n’ont pas de demande poussée, le client confirme dans son application. La page affiche un bouton « Ouvrir Wave » ou « Ouvrir Djamo » (sur mobile, il ouvre l’application) et un QR code sur ordinateur, puis surveille le paiement.
- Page hébergée : quelques agrégateurs et la plupart des paiements par carte passent par la page du fournisseur, puis reviennent.
| Passerelle | Pays | Où se passe le paiement | Transferts sortants |
|---|---|---|---|
| PayDunya | Sénégal, Côte d’Ivoire, Bénin, Togo, Mali, Burkina Faso | Dans la page (demande poussée sur le téléphone) | Oui |
| PawaPay | Bénin, Burkina Faso, Cameroun, Côte d’Ivoire, RD Congo, Éthiopie, Gabon, Ghana, Kenya, Lesotho, Malawi, Mozambique, Nigeria, Congo, Rwanda, Sénégal, Sierra Leone, Tanzanie, Ouganda, Zambie | Dans la page (demande poussée sur le téléphone) | Oui |
| Hub2 (une passerelle par pays) | Côte d’Ivoire, Sénégal, Bénin, Mali, Burkina Faso, Togo, Cameroun | Dans la page (demande poussée, code si besoin) ; Wave : lien d’application | Oui |
| Wave Business | Côte d’Ivoire, Sénégal, Mali, Burkina Faso | Lien d’application : bouton « Ouvrir Wave » et QR code sur la page, confirmation dans l’application | Non |
| Djamo Business (une passerelle par pays) | Côte d’Ivoire, Sénégal | Lien d’application : bouton « Ouvrir Djamo » et QR code sur la page, confirmation dans l’application | Non |
| PayTech | Sénégal, Côte d’Ivoire, Mali, Bénin | Page PayTech pré-remplie avec le numéro saisi sur la page, soumise automatiquement | Non |
| Magma OnePay | Côte d’Ivoire, Sénégal, Bénin, Togo, Mali, Burkina Faso, Cameroun | Mobile Money dans la page (code de confirmation si l’opérateur l’exige) ; Wave et carte : page hébergée | Non |
| iPay Money | Niger, Bénin | Mobile Money dans la page (demande poussée sur le téléphone) ; carte : page hébergée | Non |
| FeexPay | Bénin, Togo, Côte d’Ivoire, Sénégal, Burkina Faso, Congo | Mobile Money dans la page (demande poussée sur le téléphone) ; carte : page hébergée | Oui |
| MonetBill | Cameroun, Sénégal, RD Congo, Congo, Ouganda | Mobile Money dans la page (demande poussée sur le téléphone) ; carte : page hébergée | Oui |
| FedaPay | Bénin, Togo, Côte d’Ivoire, Sénégal, Guinée, Mali, Burkina Faso, Niger | Dans la page (demande poussée sur le téléphone) | Oui |
| NotchPay | Cameroun, Côte d’Ivoire, Sénégal, Bénin, Togo, Burkina Faso, Mali, Guinée, Nigeria | Dans la page (demande poussée sur le téléphone) | Oui |
| Qosic | Bénin, Togo, Côte d’Ivoire | Dans la page (demande poussée sur le téléphone) | Non |
| Paystack | Nigeria, Ghana, Afrique du Sud, Kenya, Côte d’Ivoire, Égypte, Rwanda | Mobile Money Ghana et Kenya dans la page (code par SMS) ; carte : page hébergée | Oui |
| Flutterwave | Nigeria, Ghana, Kenya, Ouganda, Tanzanie, Rwanda, Afrique du Sud, Zambie, Côte d’Ivoire, Sénégal, Cameroun, Burkina Faso, Malawi, Égypte | Page hébergée du fournisseur | Oui |
| CinetPay | Côte d’Ivoire, Sénégal, Mali, Togo, Bénin, Burkina Faso, Cameroun, RD Congo, Guinée, Niger | Page hébergée du fournisseur | Non |
| Kkiapay | Bénin, Togo, Côte d’Ivoire, Sénégal | Page hébergée du fournisseur | Non |
| PayPlus | Bénin, Togo, Burkina Faso, Côte d’Ivoire | Page hébergée du fournisseur | Non |
| LengoPay | Guinée, Maroc, Sénégal, Côte d’Ivoire | Page hébergée du fournisseur | Non |
| Stripe | Cartes bancaires, monde entier | Carte saisie dans la page (formulaire intégré) | Non |
| Coinbase Commerce | Crypto, monde entier | Page hébergée du fournisseur | Non |
| Cryptomus | Crypto, monde entier | Page hébergée du fournisseur | Non |
Les transferts sortants (envoyer de l’argent vers un compte Mobile Money) utilisent les mêmes passerelles : voir Envoyer de l’argent.
Webhooks à déclarer chez l’agrégateur
Section intitulée « Webhooks à déclarer chez l’agrégateur »La plupart des agrégateurs reçoivent l’adresse de rappel avec chaque paiement. Trois d’entre eux exigent qu’elle soit déclarée dans leur portail : le tiroir de configuration de la passerelle vous l’affiche, de la forme https://cartflox.com/api/webhooks/<passerelle>.
| Passerelle | Où la déclarer | Secret à reporter dans Cartflox |
|---|---|---|
| Wave Business | Portail Wave Business, Développeurs, Webhooks (événements checkout.session.completed et checkout.session.payment_failed) |
Le secret de signature wave_xx_WHS_… remis à la création (facultatif : sans lui, chaque succès est reconfirmé auprès de Wave) |
| Djamo Business | Sujet charge/events auprès de Djamo Business |
Le secret de signature, si vous en définissez un |
| iPay Money | Menu Développeurs, Webhooks | Le Secret-Hash que vous y définissez |
Dans tous les cas, un paiement n’est jamais crédité sur la seule foi d’un webhook non signé : Cartflox reconfirme le succès auprès de l’agrégateur avant de vous prévenir.