Ambiente de Sandbox

Teste todas as funcionalidades do Tap to Pay em um ambiente seguro e isolado, sem afetar dados reais de produção. O sandbox permite simular cenários reais de transação, incluindo sucessos e erros retornados pela adquirente.

O que é Sandbox?

Sandbox é um ambiente de testes completo que replica o comportamento do ambiente de produção.

Transações seguras

Teste transações sem processar valores reais

Simulação de erros

Simule erros retornados pela adquirente sem depender de transações reais

Validação completa

Valide o tratamento de erros e fluxos de sucesso da sua aplicação

Quando usar Sandbox

Fase	Descrição
Desenvolvimento	Durante toda a fase de desenvolvimento do seu aplicativo
Testes	Para validar casos de uso, fluxos de erro e cenários específicos
Homologação	Antes de submeter o app à produção

Credenciais de teste

No ambiente sandbox, utilize as credenciais fornecidas pela Zoop:

Credencial	Onde encontrar
IDs de merchant de teste	Painel da Zoop
Credenciais de SDK	Gerados para sua conta sandbox
Dados de cartão de teste	Use cartões reais — o sandbox não processará débitos reais

🔑
Credenciais de SDK: Obtenha as credenciais de SDK a partir da organização Zoop Sandbox (4e66************). Entre em contato com o time Zoop para solicitar acesso.

📦
SDK de Sandbox obrigatório: Para que o ambiente de sandbox funcione corretamente, utilize a dependência de sandbox no seu projeto:
// Android
debugImplementation('com.zoop.sdk:taponphone-sandbox-debug')
// IOS
sandbox-zoop-sdk-taponphone-ios-{versão}
Não use o SDK de produção em ambiente de sandbox — as transações não serão simuladas corretamente.

Simulando transações de teste

O sandbox simula respostas da adquirente, permitindo reproduzir cenários de sucesso e de erro sem depender do ambiente de produção. A simulação é controlada pelo valor da transação.

Como funciona a simulação

Ao usar valores na faixa de R$ 5,01 a R$ 5,99, o sandbox instrui a adquirente simulada a retornar um erro específico. O código de erro é derivado dos dois últimos dígitos do valor (amount % 100), gerando códigos no formato 40xx.

Valor da transação = R$ 5,00 + (sufixo do erro em centavos)
Código de erro gerado = 40 + sufixo

Exemplo: Para simular o erro 4036, use o valor R$ 5,36 (5,00 + 36 centavos).

Erros da adquirente disponíveis para simulação

Erros de autorização e cartão (4001–4058)

Valor	Código	Descrição
R$ 5,01	`4001`	Transação não concluída. Consulte o emissor do seu cartão.
R$ 5,03	`4003`	Vendedor ou Estabelecimento verifique os dados cadastrais. Entre em contato sua central de atendimento.
R$ 5,05	`4005`	Transação não autorizada. Use outro cartão.
R$ 5,06	`4006`	Ocorreu um problema técnico. Tente novamente ou contate o suporte para assistência.
R$ 5,09	`4009`	Transação está em andamento.
R$ 5,12	`4012`	Transação não concluída. Processando fechamento contábil.
R$ 5,13	`4013`	Valor da transação não permitido. Tente novamente.
R$ 5,14	`4014`	Cartão não é válido. Use outro cartão.
R$ 5,15	`4015`	Transação não concluída. Não foi possível encontrar informações sobre a Instituição.
R$ 5,19	`4019`	Refaça a transação.
R$ 5,21	`4021`	Transação não permitida para este cartão. Use outro cartão.
R$ 5,22	`4022`	Entre em contato com a central do seu cartão.
R$ 5,23	`4023`	Senha inválida. Tente novamente.
R$ 5,24	`4024`	Entre em contato com a central do seu cartão.
R$ 5,30	`4030`	Ocorreu um problema técnico. Por favor, contate o suporte para assistência.
R$ 5,31	`4031`	Transação não concluída. Este banco não faz parte da adquirente.
R$ 5,38	`4038`	Número de tentativas de senha excedido.
R$ 5,41	`4041`	Transação não concluída. Cartão extraviado.
R$ 5,43	`4043`	Transação não concluída. Cartão roubado.
R$ 5,51	`4051`	Transação não concluída. Saldo insuficiente na conta.
R$ 5,52	`4052`	Conta corrente não cadastrada para transações. Atualize os dados.
R$ 5,53	`4053`	Transação não permitida para este cartão. Use outro cartão.
R$ 5,54	`4054`	Transação não concluída. Cartão do cliente está vencido.
R$ 5,55	`4055`	Transação não concluída. Senha digitada está incorreta.
R$ 5,56	`4056`	Transação não concluída. Cartão sem registro.
R$ 5,57	`4057`	Transação não permitida para esse cliente. Use outro cartão.
R$ 5,58	`4058`	Transação não autorizada.

Erros de limite e processamento (4060–4096)

Valor	Código	Descrição
R$ 5,60	`4060`	Transação não autorizada. Ligue para obter autorização.
R$ 5,61	`4061`	Transação não autorizada. Limite de saque excedido.
R$ 5,73	`4073`	Excedido o limite de tempo para finalizar a transação. Tente novamente.
R$ 5,75	`4075`	Excedido o número permitido de tentativas de transações com senha.
R$ 5,76	`4076`	Transação não autorizada. Conta de destino especificada inválida.
R$ 5,77	`4077`	Transação não autorizada. Conta do Titular do cartão não especificado.
R$ 5,78	`4078`	Transação não autorizada. Conta especificada inválida.
R$ 5,79	`4079`	Transação não permitida neste ciclo. Tente novamente mais tarde.
R$ 5,80	`4080`	A transação não consta na base de dados da adquirente.
R$ 5,81	`4081`	A transação foi estornada.
R$ 5,82	`4082`	Transação não concluída. Problema na criptografia da transação.
R$ 5,83	`4083`	Excedido o limite de tempo para finalizar a transação. Tente novamente.
R$ 5,84	`4084`	Ciclo de autorização inválido.
R$ 5,86	`4086`	A transação foi desfeita.
R$ 5,90	`4090`	Transação não concluída. Processando fechamento contábil.
R$ 5,91	`4091`	Transação não concluída. Falha de comunicação. Tente novamente mais tarde.
R$ 5,96	`4096`	Ocorreu um problema técnico. Por favor, contate o suporte para assistência.

Como testar

Para testar o comportamento da aplicação quando a adquirente retorna um erro (exemplo: erro 4036):

Abra seu aplicativo em ambiente de sandbox.
Inicie um fluxo de pagamento.
Digite o valor de R$ 5,36 (calculado: 5,00 + 36 centavos).
Complete a transação normalmente.
O sandbox retornará o código de erro 4036.
Valide se sua aplicação:
- Exibe a mensagem de erro da adquirente corretamente
- Permite nova tentativa
- Registra o erro adequadamente

Consulte a lista completa de códigos de erro para identificar todos os cenários disponíveis.

Fluxo de teste completo

O fluxo de teste no sandbox segue o mesmo caminho da produção:

Aplicação → SDK Zoop → Terminal Simulado → Adquirente Simulado → Resposta

Cada etapa do fluxo é simulada, permitindo validar:

Inicialização do SDK
Captura do cartão
Comunicação com adquirente
Tratamento de respostas (sucesso ou erro)
Atualização da interface

Próximas etapas

Após testar no sandbox, prepare-se para produção:

Valide todos os cenários de erro críticos
Implemente tratamento robusto de erros
Teste a integração ponta a ponta
Prepare a migração para produção