Démarrage rapide

1. Obtenez votre clé API

Connectez-vous sur app.saspay.me et copiez votre clé API secrète depuis la section Développeur de votre tableau de bord.

Authorization: Bearer sk_test_xxxxxxxxxxxxxxxx

Utilisez une clé sk_test_... pour tester sans argent réel, sk_live_... une fois prêt à encaisser en production.

2. Découvrez les pays et réseaux supportés

Avant d’initier un paiement, vérifiez quels réseaux mobile money sont disponibles dans le pays de votre client. Cet appel ne nécessite aucune authentification.

curl https://api.saspay.me/api/v1/countries/

Repérez le code du réseau qui vous intéresse (ex. mtn_bj pour MTN Bénin) via Liste des réseaux.

3. Encaissez un paiement

Deux façons d’encaisser sont disponibles selon votre intégration.

Softpay (direct)
Checkout hébergé

Poussez directement une demande de paiement sur le téléphone du client — idéal si vous avez déjà son numéro et son réseau.

curl -X POST https://api.saspay.me/api/v1/payments/softpay/ \
  -H "Authorization: Bearer sk_test_xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 3fa85f64-5717-4562-b3fc-2c963f66afa6" \
  -d '{
    "amount": "2500.00",
    "currency": "XOF",
    "country": "BJ",
    "network": "mtn_bj",
    "description": "Abonnement mensuel",
    "customer": {
      "email": "client@example.com",
      "first_name": "Awa",
      "last_name": "Sossou",
      "phone": "+22997505050"
    }
  }'

Réponse

{ "message": "Payment pushed successfully", "id": "b1f2c3d4-...", "status": "PENDING", "checkout_url": "" }

Le header Idempotency-Key est obligatoire ici — générez un identifiant unique (UUID par exemple) par tentative de paiement. Voir Idempotence.

Le client reçoit l’invite de paiement directement sur son téléphone (USSD ou notification, selon le réseau). Suivez ensuite l’étape 4 pour connaître le résultat.

Générez une page de paiement à laquelle rediriger votre client — idéal si vous ne voulez pas gérer l’interface de paiement vous-même.

curl -X POST https://api.saspay.me/api/v1/checkout-sessions/ \
  -H "Authorization: Bearer sk_test_xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": "5000.00",
    "currency": "XOF",
    "description": "Facture #1042",
    "customer_email": "client@example.com",
    "customer_name": "Awa Sossou"
  }'

Réponse

{ "id": "c9a1...", "slug": "kZ2v9rT4bQxL8mNpYw==", "checkout_url": "https://pay.saspay.me/checkout/kZ2v9rT4bQxL8mNpYw==", "status": "PENDING" }

Redirigez votre client vers checkout_url — il y choisit son réseau et confirme le paiement lui-même.

4. Vérifiez le résultat

Ne faites jamais confiance à un simple délai — interrogez toujours le statut réel avant de considérer un paiement comme réussi.

curl https://api.saspay.me/api/v1/payments/b1f2c3d4-.../verify/ \
  -H "Authorization: Bearer sk_test_xxxxxxxxxxxxxxxx"

Réponse

{ "message": "Payment transaction fetched successfully", "id": "b1f2c3d4-...", "status": "SUCCESS", "net_amount": "2500.00", "currency": "XOF" }

Plutôt que d’interroger cet endpoint en boucle, configurez un webhook pour être notifié en temps réel dès que le statut change.

Prochaines étapes

Paiements

Softpay, checkout hébergé, retry, confirmation OTP

Retraits

Payer un bénéficiaire en mobile money

Webhooks

Recevez vos événements en temps réel

KYC

Vérifiez votre identité pour activer votre compte

​1. Obtenez votre clé API

​2. Découvrez les pays et réseaux supportés

​3. Encaissez un paiement

​4. Vérifiez le résultat

​Prochaines étapes

Paiements

Retraits

Webhooks

KYC

1. Obtenez votre clé API

2. Découvrez les pays et réseaux supportés

3. Encaissez un paiement

4. Vérifiez le résultat

Prochaines étapes