Pré-requisitos
Antes de iniciar os testes, certifique-se de que as seguintes configurações estejam corretas:Credenciais da API
Credenciais de API e token de acesso válidos para autenticação.
Configuração da conta
Configuração adequada da conta para o país de destino e verificação da empresa.
Lista branca de IPs
Adicione os endereços IP do seu servidor à lista de permissões para acesso à API.
Endpoint do webhook
Configure um URL de webhook para receber notificações de pagamento.
Ambiente de Sandbox
O ambiente de teste é uma réplica completa do nosso sistema de produção, projetado especificamente para testes:Processamento realista
Simula fluxos e prazos de pagamento reais.
Sem dinheiro de verdade
Todas as transações utilizam dados de teste.
Conjunto completo de recursos
Todos os métodos e operações de pagamento estão disponíveis.
Testes isolados
Os dados do seu ambiente de teste são mantidos separados dos dados de produção.
Dados de teste
Pagamentos com cartão
Teste pagamentos com cartão de crédito e débito em diversos cenários:
Detalhes do cartão padrão:
- Data de validade: Qualquer data futura (ex.: 12/2029)
- CVC: Qualquer número de 3 dígitos (ex.: 123) para cartões Mastercard e Visa ou qualquer número de 4 dígitos (ex.: 1234) para cartões American Express.
- Nome do titular do cartão: Qualquer nome de teste (ex.: “John Doe”)
Teste de Cenários de Erro
Erros de validação
- Omitir campos obrigatórios (paymentMethod, amount)
- Usar formatos inválidos (moeda incorreta, números de documentos inválidos)
- Testar restrições de parâmetros (limites de valor, restrições de país)
Testes de autenticação
- Utilizar tokens de acesso expirados
- Teste com credenciais inválidas
- Verifique as restrições da lista branca de IPs
Teste de Webhook
Certifique-se de que seu endpoint de webhook esteja lidando corretamente com as notificações:Configuração do endpoint
- Verificar requisito HTTPS
- Teste de verificação de assinatura
- Confirme imediatamente a resposta 200 OK.
Processamento de eventos
- Teste todos os tipos de eventos (payins, payouts, virtual accounts)
- Verificar o tratamento da idempotência
- Confirme o processamento assíncrono.
Tratamento de erros
- Teste cenários de tempo limite
- Verificar lógica de repetição
- Monitorar falhas de entrega
Simulação de Virtual Account (Estágio)
Para integrações de Virtual Account, a Localpayment fornece um endpoint de simulação dedicado para testar todo o ciclo de vida (Criação -> Financiamento -> Notificação).Pagamentos em Virtual Account (Simulação)
Para simular um pagamento bem-sucedido no ambiente Stage, utilize os mesmos dados do beneficiário (nome, tipo de documento e ID do documento) fornecidos na criação da Virtual Account. Não são necessárias identidades de teste separadas; o endpoint Simulate a Virtual Account Payment validará os dados do pagador em relação às informações registradas durante a criação da conta.Cenários de teste principais:
Importante
- Mapeamento de campos: Na chamada de simulação, use o
beneficiary.bank.account.numberretornado por Get Virtual Account Status para identificar a conta de destino. OexternalIdna requisição de simulação deve ser um identificador único da transação de payin — use um valor diferente para cada requisição. Inclua também o seu accountNumber (Merchant ID) real para identificar o projeto. - Identidades: utilize os mesmos dados do beneficiário (nome, tipo de documento e ID) fornecidos ao criar a Virtual Account. Consulte o Guia de Simulação Completo para obter detalhes.
Lista de verificação de validação
Antes de iniciar a produção, verifique:- Fluxos de pagamento: Confirme se todos os métodos de pagamento funcionam corretamente, incluindo cenários de sucesso e de erro.
- Tratamento de Webhooks: Garantir que todos os eventos de webhook sejam recebidos, verificados e processados conforme o esperado.
- Tratamento de erros: Exibir mensagens de erro claras para os usuários e implementar a lógica de repetição adequada quando necessário.
- Segurança: Imponha o uso de HTTPS, verifique as assinaturas e assegure que todos os dados sensíveis sejam tratados com segurança.
- Experiência do usuário: Forneça estados de carregamento claros, mensagens úteis e fluxos de redirecionamento suaves ao longo de toda a jornada de pagamento.
Ferramentas de teste
Baixe nossa coleção completa do Postman com cenários de teste pré-configurados:Coleção do Postman
Obtenha a coleção completa de testes com modelos de ambiente.

