Ambiente de teste
O ambiente de teste é a mesma API, na mesma base URL, com o mesmo código. O que muda é a chave: uma
chave sk_test_ põe a requisição no teste, uma sk_live_ põe em produção.
Não existe host separado, não existe versão diferente e não existe campo mode para mandar na
requisição. O ambiente vem da chave, e só dela.
Os dois mundos não se tocam
Uma cobrança criada no teste nunca aparece em produção, e vice-versa. Consultar com a chave de teste
um id de produção responde 404, não 403: a resposta não confirma que aquele objeto existe.
Saldo, saques, eventos, entregas de webhook e limites diários são todos separados por ambiente.
O que o teste não faz
- Não move dinheiro. Nenhum valor sai ou entra de conta bancária nenhuma.
- Não gera QR pagável. O
pix.payloadé um BR Code bem formado, mas nenhum app de banco de verdade paga ele. Quem paga é você, pelo valor da cobrança. Ver Gatilhos. - Não exige KYC para cobrar. A chave de teste funciona com a conta em qualquer estado, menos encerrada. É o que permite integrar o checkout inteiro enquanto a análise dos seus documentos ainda corre.
O que continua igual ao de produção
Tudo o mais. Vale a pena listar, porque é aí que o teste tem valor:
- As mesmas validações, os mesmos códigos de erro e o mesmo envelope.
- A mesma obrigatoriedade de
Idempotency-Key, com o mesmo comportamento de replay. - Os mesmos limites de chamadas por minuto e as mesmas faixas de valor.
- Os mesmos webhooks, assinados do mesmo jeito, com o mesmo esquema de retentativa.
- A mesma paginação e os mesmos filtros.
Um checkout que passa no teste passa em produção, desde que você tenha exercitado também os caminhos ruins.
Saque no ambiente de teste
Saque no teste não exige KYC aprovado, mas exige uma chave PIX verificada, e a chave PIX é o documento aprovado no seu KYC. Na prática: até o KYC sair, você testa cobrança, webhook e consulta, mas não o fluxo de saque.
Detalhes em Chave PIX.
Próximo passo
Gatilhos: como fazer uma cobrança de teste pagar, expirar, falhar ou duplicar o webhook.
Referência: Saldo e agregados do seller no mode da API key devolve o saldo do ambiente da chave que você usou.