> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mercy-pay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Démarrage rapide

> Créez votre espace marchand et encaissez un premier paiement de test en sandbox.

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

> [!TIP]
>
> 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.

**1. 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**.

![L'onglet Clés API de la console Développeurs](https://docs.mercy-pay.com/images/developers/console-api-keys-light.webp)
![L'onglet Clés API de la console Développeurs](https://docs.mercy-pay.com/images/developers/console-api-keys-dark.webp)

**2. Vérifiez votre clé**

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
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 :

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "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": []
  }
}
```

**3. 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](https://docs.mercy-pay.com/payments/amounts-and-currencies.md).

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
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 :

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "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"
  }
}
```

**4. 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 :

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
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](https://docs.mercy-pay.com/developers/webhooks/overview.md).
* Suivez vos requêtes, vos webhooks et vos erreurs dans la [console Développeurs](https://docs.mercy-pay.com/developers/console.md).
* Passez en live une fois votre KYC approuvé : [Environnements](https://docs.mercy-pay.com/start/environments.md).
* 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](https://docs.mercy-pay.com/payments/accept-a-payment.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.