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¶
| Service | URL |
|---|---|
| Services API (cards, BINs, products) | https://sandbox.qpay.quecto.com.br |
| Credentials API (users, clients, tokens) | https://sandbox.qpay.quecto.com.br |
| API docs (interactive) | https://sandbox.qpay.quecto.com.br/docs |
| Token endpoint | https://sandbox.qpay.quecto.com.br/auth/realms/qpay/protocol/openid-connect/token |
Characteristics¶
| Property | Sandbox | Production |
|---|---|---|
| Card network | Test / simulated | Live UnionPay |
| Data isolation | Fully isolated from production | — |
| Transactions | Simulated via Issuer Simulator | Live authorization |
| Embossing | Simulated | Physical card bureaus |
| Uptime SLA | Best-effort | 99.9% |
| Rate limits | Relaxed | Standard |
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 (data preparation templates) associated with that BIN
- Sample card layouts and product configurations
Contact support@quecto.com.br to request additional test data or a sandbox reset.
Checking service health¶
curl https://sandbox.qpay.quecto.com.br/credentials/whoami \
-H "Authorization: Bearer <access_token>"
A 200 OK response confirms the service is reachable and your token is valid.
Getting help¶
| Channel | Use for |
|---|---|
| support@quecto.com.br | Tenant requests, access issues |
| GitHub Issues | API bugs, documentation feedback |