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)

Pour les paiements par carte (CARD, VISA, MASTERCARD, GIM_UEMOA), ajoutez customer_name et customer_email dans le body.

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, Wave, Moov… Tout passe par SahelPay

❌ 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