ZyndPay / developers

Sandbox & testing

Sandbox mode is isolated: a separate database, no on-chain broadcast, and pre-seeded test data. Enable it in one of two ways.

Header mode

Send x-zyndpay-sandbox: true on every request with your sandbox API key. Simplest for one-off testing.

curl -X POST https://api.zyndpay.io/v1/paylinks \
  -H "Authorization: Bearer zpk_sandbox_XXX" \
  -H "x-zyndpay-sandbox: true"

Sandbox API key

Any key prefixed zpk_sandbox_ is automatically routed to the sandbox runtime. Recommended for CI.

Seeded test data

  • Test MoMo numbers that deterministically succeed, delay, or fail
  • Test USDT addresses that simulate instant settlement
  • A test customer email that bypasses KYC gating
  • A webhook echo endpoint at /v1/sandbox/echo for signature debugging
Was this helpful?