Skip to main content

Guide d’intégration

Ce guide détaille le flow complet d’intégration SahelPay pour une application marchande.

Principes fondamentaux

Règles non négociables :
  • Votre app est un MERCHANT SahelPay, pas un PSP
  • Votre app NE calcule AUCUN frais - SahelPay gère tout
  • Le webhook est la SEULE source de vérité pour le statut paiement

Architecture

Flow détaillé

1. Créer le paiement (Backend)

Interrogez GET /v1/providers/enabled pour connaître les rails activés plutôt que de les coder en dur.

2. Rediriger le client

3. Recevoir le webhook

Idempotence

Côté création

Utilisez X-Idempotency-Key basé sur l’order_id :

Côté webhook

Vérifiez si le paiement est déjà traité avant de mettre à jour :

Ce que votre app NE DOIT PAS faire

❌ Appeler les providers directement

Orange Money aujourd’hui, d’autres rails ensuite : une seule intégration

❌ Calculer des frais

SahelPay gère les frais automatiquement

❌ Créer un wallet

Pas de stockage de solde dans votre app

❌ Marquer PAID sans webhook

Le return_url est pour l’UX uniquement