Tester sans risque

Tu peux dérouler toute l’intégration — commande, webhook, signature — sans toucher à tes vraies ventes. Les commandes créées en sandbox portent isTest: true, un identifiant préfixé TEST-, et n’entrent ni dans tes revenus, ni dans ton solde vendeur, ni dans tes statistiques.

1. Obtenir une clé sandbox

Espace vendeur → Boutique → Boutique en ligne → Clés d’API, en cochant sandbox à la création (sandbox: true). Comme toute clé, elle n’est affichée qu’une fois, et elle porte les mêmes scopes.

2. Simuler une commande

POST /partner/v1/sandbox/orders (scope orders:write) crée une commande de test et déclenche un vrai webhook ORDER_CREATED, signé exactement comme en production. Le corps est optionnel : sans lui, on choisit des articles de ton catalogue.

curl -X POST https://backend.generale-ci.com/partner/v1/sandbox/orders \
  -H "X-Api-Key: VOTRE_CLE_SANDBOX" \
  -H "Content-Type: application/json" \
  -d '{"itemIds":["cl…"]}'

curl -X POST 'https://backend.generale-ci.com/partner/v1/sandbox/orders' \
  -H 'X-Api-Key: VOTRE_CLE' \
  -H 'Content-Type: application/json' \
  -d '{
  "itemIds": []
}'

3. Vérifier la réception du webhook

Ton endpoint doit recevoir un ORDER_CREATED dans la seconde. Vérifie la signature comme en production (Webhooks sortants) : c’est justement l’intérêt, le webhook de test n’est pas un cas particulier.

Le journal des livraisons reste consultable : GET /seller/webhooks/deliveries.

4. Remettre à zéro

POST /partner/v1/sandbox/reset efface les commandes de test.

curl -X POST 'https://backend.generale-ci.com/partner/v1/sandbox/reset' \
  -H 'X-Api-Key: VOTRE_CLE'

Résumé