Skip to main content

​
Passer en production

La sandbox est gratuite et sans limite de durée. Encaisser de vrais paiements Orange Money demande un compte activé et un abonnement SahelPay payé.

​
Conditions pour encaisser en live

1

KYC approuvé

Complétez votre vérification dans le dashboard. Le live exige un KYC approuvé de niveau Starter ou Business.
2

Activation de la production

Activez le mode production dans le dashboard. L’accès production est ensuite ouvert compte par compte par SahelPay.
3

Abonnement payé

Choisissez et payez un forfait dans Mon offre (dashboard). Le live n’est ouvert que pendant une période payée et en cours.
4

Clés live

Utilisez votre clé sk_live_... et configurez votre URL webhook de production.
Les membres du Programme Partenaires SPAY dont le contrat est validé encaissent en production sans abonnement : SahelPay est alors le vendeur.

​
Ce qui se passe sans abonnement

  • Sans période payée (ou après expiration), tout le compte fonctionne en sandbox.
  • Une clé sk_live_... est alors refusée avec 403 PAID_SUBSCRIPTION_REQUIRED : un vrai client ne doit jamais croire avoir payé.
  • Le renouvellement rouvre le live automatiquement, sans autre action.

​
Plafonds d’encaissement live

Chaque forfait fixe un volume encaissé maximal par mois civil (UTC) : Les tarifs à jour sont publiés par GET /v1/sahelpay/plans (public) et dans le dashboard. Votre forfait courant est lisible via GET /v1/merchant/plan et GET /v1/merchant/subscription (clé secrète). Ce qui compte dans le plafond :
  • les paiements live PENDING et SUCCESS du mois ;
  • un paiement INITIATED (checkout ouvert mais pas encore validé) réserve son montant pendant 30 minutes ;
  • les paiements sandbox ou simulés ne comptent jamais.
Des plafonds journaliers et mensuels liés à votre niveau KYC peuvent aussi s’appliquer.

​
Libellé côté client

Sur la page Orange Money, vos paiements apparaissent sous le libellé SPAY-<nom du marchand> (30 caractères maximum). Les paiements dus à SahelPay elle-même (votre abonnement) restent libellés « SahelPay ». Le paiement de votre abonnement SahelPay n’est jamais traité comme une vente : il ne déclenche aucun webhook vers votre intégration et n’entre pas dans vos encaissements.

​
Checklist