Orchestration multi-passerelles

Vous pouvez brancher plusieurs passerelles et décider, opérateur par opérateur et pays par pays, laquelle encaisse. Si elle échoue, Cartflox bascule automatiquement sur la suivante.

Dans le tableau de bord

1. Passerelles : ajoutez chaque agrégateur avec ses clés, validées à l’enregistrement.

2. Moyens de paiement : pour chaque opérateur (Orange Money Côte d’Ivoire, Wave Sénégal, MTN Bénin…), choisissez la passerelle qui le sert, ou laissez Cartflox choisir.

3. Le moteur de routage mémorise le taux de succès de chaque passerelle et privilégie celles qui aboutissent le plus.

Par l’API

GET/v1/route?country=SN&providers=paydunya,cinetpay&currency=XOFOpérateurs disponibles et classement des passerelles pour un pays

curl

curl "https://cartflox.com/api/v1/route?country=SN&providers=paydunya,cinetpay&currency=XOF"

200 OK

{
  "country": "SN",
  "currency": "XOF",
  "availableMethods": [ { "code": "wave", "name": "Wave", "providers": ["paydunya", "cinetpay"] } ],
  "rankedProviders": [ "paydunya", "cinetpay" ]
}

POST/v1/routeDécision de routage pour un paiement précis (clé API requise)

Paramètre	Type	Requis	Description
country	string	Oui	Code pays ISO alpha-2
amount	number	Oui	Montant
availableProviders	string[]	Oui	Passerelles candidates (paydunya, cinetpay, pawapay, fedapay, stripe…)
currency	string	Non	Devise
paymentMethod	string	Non	Opérateur souhaité (wave, orange, mtn, moov, card…)
phone	string	Non	Numéro du client : l’opérateur est déduit du préfixe si paymentMethod est absent
preferredProvider	string	Non	Forcer une passerelle

200 OK

{
  "routing": { "provider": "paydunya", "method": "orange", "reason": "best_success_rate" },
  "detectedOperator": "orange",
  "availableMethods": [ "..." ],
  "rankedProviders": [ "paydunya", "cinetpay" ]
}

Les valeurs acceptées pour providers : paydunya, pawapay, flutterwave, feexpay, paystack, cinetpay, stripe, kkiapay, coinbase, fedapay, notchpay, cryptomus, qosic, monetbill, payplus, hub2, lengopay, wave, paytech, onepay, djamo, ipay.