Votre premier paiement

Parcours Sandbox de bout en bout, avec les étapes réellement disponibles.

  1. Créer un compte

    Inscrivez-vous via Créer un compte ou POST /api/merchant/auth/register.

  2. Créer une boutique

    Depuis le dashboard, ou POST /api/merchant/organizations/:orgId/stores (session + CSRF).

  3. Rester en Sandbox

    Le mode test est isolé et n’utilise pas les opérateurs réels.

  4. Créer une clé API

    Dans Clés API, créez une clé Sandbox. Le secret sk_test_… n’est affiché qu’une fois.

  5. Créer un paiement
    cURL
    curl -X POST http://localhost:4000/v1/payments \
  -H "Authorization: Bearer sk_test_…" \
  -H "Idempotency-Key: demo-payment-001" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 25000,
    "sandboxScenario": "SUCCESS",
    "merchantReference": "order_001"
  }'
  6. Checkout via lien (optionnel)

    Créez un lien de paiement, puis ouvrez l’URL publique /pay/:token pour le parcours client.

  7. Recevoir le résultat

    Consultez le paiement via GET /v1/payments/:id, le dashboard, ou le webhook Sandbox POST /v1/webhooks/sandbox.

  8. Passer en Production

    Après KYC / KYB, capacités et contrats opérateurs. Voir Passer en production.