Tests

Utilisez l’environnement sandbox pour tester votre intégration avant de passer en production.

Environnement Sandbox

	Sandbox	Production
URL	`https://api.sahelpay.ml`	`https://api.sahelpay.ml`
Clés	`sk_test_xxx`	`sk_live_xxx`
Transactions	Sandbox opérateur ou simulateur SahelPay	Réelles

Le sandbox est un mode logique porté par la clé sk_test_.... N’utilisez pas de base URL différente pour les SDK.

Montants de test

Deux modes de test coexistent, et ils ne font pas la même chose :

Metadata	Option SDK	Effet
`sandbox: true`	`sandbox`	Appelle l’environnement de test de l’opérateur. Valide l’intégration de bout en bout.
`sahelpay_mock: true`	`mock`	Utilise le simulateur SahelPay. Aucun appel opérateur.

Avec le simulateur SahelPay (sahelpay_mock: true), le statut final est piloté par le montant :

Montant	Comportement
`4000`	Paiement réussi
`4001`	Paiement échoué
`4002`	Paiement en attente
`4003`	Paiement échoué
Autre montant valide	Paiement réussi

curl -X POST https://api.sahelpay.ml/v1/payments \
  -H "Authorization: Bearer sk_test_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 4000,
    "currency": "XOF",
    "payment_method": "ORANGE_MONEY",
    "customer_phone": "+22370123456",
    "return_url": "https://votre-site.com/checkout/return",
    "metadata": { "sahelpay_mock": true, "order_id": "order_test_1" }
  }'

Tester les webhooks

Avec ngrok (local)

# Exposer votre serveur local
ngrok http 3000

# Configurer l'URL dans le dashboard
# https://xxxx.ngrok.io/api/webhooks/sahelpay

Déclencher un webhook manuellement

curl -X POST https://api.sahelpay.ml/v1/webhooks/test \
  -H "Authorization: Bearer sk_test_xxx" \
  -H "Content-Type: application/json" \
  -d '{}'

Cet endpoint envoie un événement webhook.test vers l’URL webhook configurée dans le dashboard. Pour tester un vrai webhook métier payment.success ou payment.failed, créez un paiement avec metadata.sandbox: true, puis appelez GET /v1/payments/{id}/status.

Getting Started

Guides

Resources

Tests

Tests

Environnement Sandbox

Montants de test

Tester les webhooks

Avec ngrok (local)

Déclencher un webhook manuellement

Checklist avant production

​Tests

​Environnement Sandbox

​Montants de test

​Tester les webhooks

​Avec ngrok (local)

​Déclencher un webhook manuellement

​Checklist avant production

Tests

Environnement Sandbox

Montants de test

Tester les webhooks

Avec ngrok (local)

Déclencher un webhook manuellement

Checklist avant production