Skip to main content

​
Smart Routing

SahelPay utilise un système de Smart Routing qui choisit automatiquement le meilleur gateway (provider interne) pour chaque paiement. En tant que développeur, vous n’avez qu’à spécifier la méthode de paiement souhaitée par votre client.

​
Fonctionnement

┌───────────────────────────────────────────────────────────────────┐
│  Votre Application                                                 │
│                                                                   │
│  sahelpay.payments.create({                                       │
│    payment_method: 'ORANGE_MONEY',  // ← Vous spécifiez ça        │
│    amount: 5000,                                                  │
│    ...                                                            │
│  })                                                               │
└───────────────────────────────────────────────────────────────────┘
                              │
                              ▼
┌───────────────────────────────────────────────────────────────────┐
│  SahelPay Smart Router                                            │
│                                                                   │
│  Critères:                                                        │
│  ├── Coût (frais provider)                                        │
│  ├── Disponibilité (uptime)                                       │
│  ├── Pays                                                         │
│  └── Configuration admin                                          │
│                                                                   │
│  Décision: Gateway optimal sélectionné automatiquement            │
│  (basé sur coût, disponibilité, UX)                               │
└───────────────────────────────────────────────────────────────────┘
                              │
                              ▼
┌───────────────────────────────────────────────────────────────────┐
│  Gateway interne sélectionné                                       │
│  (transparent pour vous)                                          │
└───────────────────────────────────────────────────────────────────┘

​
Méthodes de paiement

Voici les méthodes de paiement que vous pouvez utiliser :
MéthodeDescriptionCapabilities
ORANGE_MONEYOrange MoneyPaiements, Payouts, OPR
WAVEWavePaiements, QR Code, Payouts, OPR
MOOVMoov MoneyPaiements, Payouts, OPR
CARDCarte bancairePaiements, Splits
VISACarte VISAPaiements, Splits
MASTERCARDCarte MastercardPaiements, Splits
GIM_UEMOACarte GIM-UEMOAPaiements

​
Informations de Routing

Chaque paiement retourne des informations sur le gateway utilisé : 
const payment = await sahelpay.payments.create({
  amount: 5000,
  payment_method: 'ORANGE_MONEY',
  customer_phone: '+22370123456',
});

console.log(payment.gateway_used);    // Identifiant technique interne
console.log(payment.routing_reason);  // Explication du routing choisi
Ces champs sont informatifs. Vous ne pouvez pas et n’avez pas besoin de choisir le gateway - SahelPay optimise automatiquement pour le coût et la disponibilité.

​
Pourquoi le Smart Routing ?

  1. Coût optimisé : SahelPay négocie les meilleurs taux et choisit automatiquement l’option la moins chère
  2. Haute disponibilité : Fallback automatique si une méthode est temporairement indisponible
  3. Meilleure UX : Choix automatique de la meilleure expérience utilisateur (Push USSD, QR Code, etc.)
  4. Simplicité : Une seule intégration pour toutes les méthodes de paiement

​
Configuration Admin

Les administrateurs SahelPay peuvent configurer le routing via le dashboard :
  • Activer/désactiver des providers
  • Mettre un provider en maintenance
  • Définir des règles de routing par pays
  • Monitorer les performances
Ces changements sont appliqués en temps réel sans redéploiement.