Sandbox & tests

Le mode sandbox est isolé : base de données séparée, aucune diffusion on-chain, données de test pré-injectées. Activez-le de deux façons.

Via l'en-tête

Envoyez x-sandbox: true sur chaque création de paiement avec votre clé API sandbox. Équivalent à ?sandbox=true dans l'URL.

curl -X POST "https://api.zyndpay.io/v1/payments?sandbox=true" \
  -H "X-Api-Key: zyp_test_sk_..." \
  -H "x-sandbox: true"

Clé API sandbox

Les clés sandbox sont préfixées zyp_test_sk_ (secrète) ou zyp_test_pk_ (publiable). Le préfixe seul ne suffit pas — associez la clé à ?sandbox=true ou x-sandbox: true sur les appels de création de paiement. Une clé live avec le flag sandbox renvoie LIVE_KEY_SANDBOX_REQUEST ; l'inverse renvoie SANDBOX_KEY_LIVE_REQUEST.

Données de test pré-injectées

• Numéros MoMo de test qui réussissent, temporisent ou échouent de façon déterministe
• Adresses USDT de test qui simulent un règlement instantané
• Un email client de test qui contourne le KYC
• Un endpoint d'écho à /v1/sandbox/echo pour déboguer les signatures