> ## 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é.

<Steps>
  <Step title="Créez votre espace marchand">
    Depuis le tableau de bord, cliquez sur **Créer un espace marchand**. Renseignez le nom commercial, la raison sociale, le numéro d'enregistrement de votre entreprise, le pays d'activité et la devise par défaut.

    Mercy Pay génère automatiquement une clé sandbox (`mp_sandbox_…`). Copiez-la immédiatement : elle n'est affichée qu'une fois.
  </Step>

  <Step title="Vérifiez votre clé">
    ```bash theme={null}
    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={null}
    {
      "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": []
      }
    }
    ```
  </Step>

  <Step title="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](/concepts/amounts-and-currencies).

    ```bash theme={null}
    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={null}
    {
      "data": {
        "reference": "01J9Z3V8QK4M2XW7R6TB5N0HYD",
        "amount": 5000,
        "currency": "XAF",
        "description": "Consultation à domicile",
        "status": "created",
        "checkout_url": "https://mercy-pay.com/checkout/01J9Z3V8QK4M2XW7R6TB5N0HYD",
        "expires_at": "2026-10-03T10:30:00+00:00",
        "created_at": "2026-10-03T10:00:00+00:00"
      }
    }
    ```
  </Step>

  <Step title="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={null}
    curl https://mercy-pay.com/api/v1/checkout-sessions/01J9Z3V8QK4M2XW7R6TB5N0HYD \
      -H "Authorization: Bearer mp_sandbox_XXXXXXXXXXXXXXXX"
    ```
  </Step>
</Steps>

## Étapes suivantes

* Recevez les événements sur votre serveur plutôt que d'interroger l'API en boucle : [Webhooks](/webhooks/overview).
* Passez en live une fois votre KYC approuvé : [Environnements](/environments).
* 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](/guides/accept-a-payment).


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