Sandbox Environment¶

The QPay sandbox is a fully functional environment for integration development and testing. It mirrors the production platform but uses isolated data and test card networks.

Base URLs¶

Characteristics¶

Sandbox limits¶

• Maximum 50 cards per issuer tenant in the sandbox
• Access tokens expire after 5 minutes (same as production)
• Sandbox data may be reset periodically with advance notice

Test data¶

The sandbox is pre-loaded with sample data to help you get started quickly:

• A sample processor tenant with at least one BIN range configured
• A set of card templates associated with that BIN
• Sample card layouts and product configurations

Choosing a ledger¶

New issuer tenants in the sandbox start with no auth_url, which means authorization is routed to QPay's internal ledger. You can join it and start onboarding cardholders without implementing anything.

To test your own ledger instead, register your callback configuration and set auth_url. The bundled Issuer Simulator implements the six processor-facing operations of the Ledger Callback API and is a useful target while you build. Clearing auth_url routes authorization back to the internal ledger, so the switch is reversible at any time.

Contact support@quecto.com.br to request additional test data or a sandbox reset.

Checking service health¶

curl https://sandbox.qpay.quecto.com.br/api/credentials/whoami \
  -H "Authorization: Bearer <access_token>"

A 200 OK response confirms the service is reachable and your token is valid.

Getting help¶