Sandbox
Ambiente de testes. Nenhum dinheiro real é movimentado; os pagamentos são simulados de forma
determinística. Use para desenvolver e validar sua integração.
Produção
Ambiente real, conectado às adquirentes. Movimenta dinheiro de verdade.
URLs base
| Serviço | Sandbox | Produção |
|---|---|---|
| API (PSP) | https://api.sandbox.z2pay.com | https://api.z2pay.com |
| Checkout API | https://checkout-api.sandbox.z2pay.com | https://checkout-api.z2pay.com |
| Páginas hospedadas (checkout/fatura) | https://pay.sandbox.z2pay.com | https://pay.z2pay.com |
| Dashboard | acesso via botão “Ambiente de testes” | https://app.z2pay.com |
As chaves de API são específicas de cada ambiente. Uma chave de sandbox não funciona em
produção e vice-versa. Veja Autenticação.
Como acessar o sandbox
- Faça login no Dashboard de produção (
https://app.z2pay.com). - No menu de perfil, clique em “Ambiente de testes”.
- Aguarde a configuração automática do seu sandbox (na primeira vez).
- Você é redirecionado já logado no Dashboard de sandbox, onde encontra suas credenciais de teste e o painel de simulação de pagamentos.
O que muda no sandbox
O sandbox usa um provedor simulado (FakeProvider) no lugar das adquirentes reais. Isso torna os testes determinísticos:- Cartão: o desfecho (aprovado/recusado/falha) é definido pelos últimos 4 dígitos do número. Veja Cartões de teste.
- PIX e boleto: a liquidação é controlada por uma configuração por método (
instant,autooumanual), com a opção de forçar cenários por valor. Veja PIX e boleto de teste. - Chargeback: pode ser simulado. Veja Simular eventos.