Démarrage rapide

Ce guide vous mène d’un compte vierge à un paiement de test, en sandbox. Aucun argent réel n’est déplacé.

Le tableau de bord vous guide aussi pas à pas. Après la création de votre boutique, la page Faites votre premier paiement lance cette requête pour vous, sans terminal, et affiche le résultat en direct.

Créez votre espace marchand

Créez votre compte, confirmez le code reçu par e-mail, puis répondez aux 5 écrans de démarrage : nom de la boutique, pays, activité, volume estimé et façon d’encaisser.Mercy Pay génère automatiquement une clé sandbox (mp_sandbox_…). Vous la retrouvez à tout moment dans la console Développeurs, onglet Clés API, avec le bouton Copier.

Vérifiez votre clé

curl https://mercy-pay.com/api/v1/account \
  -H "Authorization: Bearer mp_sandbox_XXXXXXXXXXXXXXXX"

La réponse indique votre marchand, l’environnement de la clé et vos soldes :

{
  "data": {
    "merchant": {
      "uuid": "0b6c2f1e-6d1a-4a3e-9d0a-2f3c1b7e8a41",
      "name": "Boutique Ada",
      "status": "pending",
      "kyc_status": "not_submitted",
      "default_currency": "XAF"
    },
    "api_key": {
      "environment": "sandbox",
      "key_prefix": "mp_sandbox_XXXXXXXX"
    },
    "wallets": []
  }
}

Créez une session de checkout

Les montants sont des entiers en unités mineures : 5000 représente 5 000 XAF. Voir Montants et devises.

curl https://mercy-pay.com/api/v1/checkout_sessions \
  -H "Authorization: Bearer mp_sandbox_XXXXXXXXXXXXXXXX" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: commande-2026-0001" \
  -d '{
    "amount": 5000,
    "currency": "XAF",
    "description": "Consultation à domicile",
    "success_url": "https://boutique-ada.example/merci",
    "cancel_url": "https://boutique-ada.example/panier"
  }'

La réponse (HTTP 201) contient l’URL de la page de paiement :

{
  "data": {
    "id": "cs_01J9Z3V8QK4M2XW7R6TB5N0HYD",
    "object": "checkout_session",
    "livemode": false,
    "created": "2026-10-03T10:00:00+00:00",
    "amount": 5000,
    "currency": "XAF",
    "description": "Consultation à domicile",
    "status": "created",
    "checkout_url": "https://mercy-pay.com/paiement/01J9Z3V8QK4M2XW7R6TB5N0HYD",
    "expires_at": "2026-10-03T10:30:00+00:00"
  }
}

Payez en sandbox

Ouvrez checkout_url, choisissez Mobile Money ou Carte bancaire, puis validez. En sandbox, l’encaissement est simulé.Vérifiez ensuite le statut :

curl https://mercy-pay.com/api/v1/checkout_sessions/cs_01J9Z3V8QK4M2XW7R6TB5N0HYD \
  -H "Authorization: Bearer mp_sandbox_XXXXXXXXXXXXXXXX"

Étapes suivantes

Recevez les événements sur votre serveur plutôt que d’interroger l’API en boucle : Webhooks.
Suivez vos requêtes, vos webhooks et vos erreurs dans la console Développeurs.
Passez en live une fois votre KYC approuvé : Environnements.
Si vous préférez construire votre propre formulaire de paiement plutôt que rediriger vers la page hébergée, voyez la charge directe dans Accepter un paiement.

Démarrage

Paiements

Liens de paiement

Abonnements

Soldes et retraits

Développeurs

Étapes suivantes