Skip to main content

​
What it is

The NTX Pay sandbox lets your integration exercise cash-in, cash-out, returns, and webhooks without moving real money. The full pipeline runs — balance, limit validation, fee charging, statement, and webhook delivery — only settlement on the SPEI network is simulated.
Your integration does not change. The endpoints, payloads, and webhooks are exactly those described in the guides — once production is enabled for your company, the same code will work by simply swapping credentials. That is why this section documents only what is different in the sandbox: the test scenarios and the simulated webhooks.

​
How to enable it

Your API credentials are structurally the same as those you would use in production. The difference lives in the account: sandbox accounts route SPEI calls to NTX Pay’s internal simulator. To create a sandbox account, ask your Account Manager or write to contact@ntxpay.com — onboarding is instant and KYC is auto-approved.
Sandbox credentials are distinct from production credentials. Production credentials against the sandbox host return 401. Authentication itself is identical.

​
Base URL

All documented routes (/api/auth/token, /api/spei/cash-in, /api/spei/cash-out, /api/balance, /api/webhooks-config) are available at exactly this host.

​
Differences vs Production

​
Suggested test flow

  1. Authenticate — obtain the JWT with your sandbox credentials.
  2. Register your webhook — via POST /api/webhooks-config, exactly as in production.
  3. Create a cash-in — follow the cash-in guide; the simulated confirmation arrives in seconds.
  4. Send a cash-out — using the balance from the previous step, follow the cash-out guide.
  5. Force errors and returns — use the scenarios to exercise every path in your handler.

​
Next steps

Test scenarios

Force success, failure, return, and delay via the X-Sandbox-Scenario header.

Simulated webhooks

How to trigger each event and validate dedupe, retries, and signature.

​
Support

suporte@ntxpay.com