Ambiente de Testes#
O ambiente de testes está disponível por meio de uma conta de desenvolvedor (conta de teste).
Ele utiliza os mesmos endpoints da produção, mas com regras específicas para simulação de comportamentos.
Não há comunicação real com adquirentes, bancos ou instituições financeiras.Esse ambiente permite que você valide os fluxos de integração da sua aplicação de forma segura, sem impacto financeiro.No ambiente de testes, você poderá:Simular transações de cartão com diferentes resultados (aprovado, autorizado, recusado ou pendente).
Gerar transações PIX que mudam de status automaticamente após alguns minutos, representando o fluxo real de confirmação de pagamento.
Executar capturas e estornos para validar como sua aplicação lida com valores parciais ou totais.
Receber identificadores fictícios (TID, NSU, códigos de autorização) a cada requisição, sem validade real, apenas para testes de fluxo.
Forçar diferentes cenários de resposta a partir dos dados enviados, permitindo validar integrações em todos os possíveis status de uma transação.
Esse ambiente foi projetado para reproduzir situações comuns que ocorrem em produção, mas sem impacto financeiro real.
Ao testar, acompanhe as mudanças de status retornadas pela API para garantir que sua aplicação esteja preparada para lidar com cada caso.No ambiente de testes é possível simular diferentes resultados de autorização de cartão.
O comportamento é definido a partir do último dígito do número do cartão utilizado no request Criar uma Transação.| Último dígito do cartão | Resultado da simulação |
|---|
| 9 | Retorna um status aleatório entre PAID, AUTHORIZED ou REFUSED. |
| 8, 7, 6, 5 | Sempre retorna REFUSED. |
| 4, 3, 2, 1 | Se a transação for de captura imediata, retorna PAID. Caso contrário, retorna AUTHORIZED. |
| 0 (ou outro valor) | Sempre retorna WAITING_PAYMENT. |
Observação
Caso a transação esteja configurada para utilizar 3DS, e o status inicial seja PAID ou AUTHORIZED, o fluxo será redirecionado para autenticação.
Nesse caso, o status retornado será REQUEST_AUTHENTICATION junto de uma URL de simulação.
Simulação de Transações PIX#
No ambiente de testes é possível simular diferentes resultados para pagamentos via PIX.
A transação deve ser criada utilizando o request Criar uma Transação PIX.Após a criação, a transação será retornada inicialmente com status WAITING_PAYMENT.
Automaticamente será enfileirado um processamento interno que altera o status da transação após um atraso aleatório de 1 a 4 minutos.Valor da transação (amount) | Resultado da simulação |
|---|
| 600 | Sempre retorna REFUSED. |
| 700 | Sempre retorna CANCELED. |
| Qualquer outro valor | Sempre retorna PAID. |
Observação
O atraso de atualização do status (1 a 4 minutos) é aplicado para simular o comportamento real de compensação de um pagamento PIX.
Caso o resultado seja REFUSED, também será preenchido o campo refuse_reason com um motivo fictício de recusa.
Simulação de Boletos#
No ambiente de testes não há simulação de transações via boleto.
Esse meio de pagamento não gera comportamentos automáticos de aprovação, recusa ou compensação dentro do ambiente de testes.