Visão geral
O tratamento adequado de erros é crucial para a criação de integrações de pagamento confiáveis. O Localpayment utiliza uma estrutura de erros consistente em todos os endpoints da API para ajudar você a identificar e resolver problemas rapidamente.Códigos padronizados
Códigos de erro consistentes em todos os endpoints da API e métodos de pagamento.
Mensagens detalhadas
Descrições em linguagem acessível, com detalhes específicos sobre os erros.
Melhores práticas
Estratégias comprovadas para lidar com erros em ambientes de produção.
Códigos de resposta HTTP
O Localpayment utiliza códigos de status HTTP padrão para indicar o sucesso ou a falha das solicitações da API:Estrutura de Resposta a Erros
Quando ocorre um erro, o Localpayment retorna um objeto JSON com informações detalhadas sobre o erro:Campos de resposta de erro
Referência de Códigos de Status Internos
Embora a Localpayment use códigos HTTP padrão para o status no nível da requisição, os camposstatus.code e errors[].code fornecem o status granular da lógica de negócios e do processamento.
Cenários de erro comuns
Erros de autenticação
SoluçãoVerifique suas credenciais de API e certifique-se de que seu token de acesso seja válido. Use o endpoint de atualização de token, se necessário.
Erros de validação
SoluçãoRevise o array
errors para identificar problemas específicos de validação de campos. Consulte a documentação da API para obter informações sobre os campos obrigatórios e as especificações de formato.Erros de lógica de negócios
SoluçãoEsses erros exigem resolução em nível comercial. Verifique os saldos da conta, os limites de transação ou entre em contato com o suporte para obter informações sobre restrições específicas.
Melhores práticas para tratamento de erros
Dica profissionalImplemente o registro estruturado de logs desde o primeiro dia. Inclua IDs de correlação, códigos de erro e informações de contexto para facilitar a depuração quando ocorrerem problemas em produção.
- Implementar registro abrangente de logs
- Mensagens de erro fáceis de usar
Crie um mapeamento de códigos de erro técnicos para mensagens amigáveis ao usuário:
- Mecanismo de Repetição com Recuo Exponencial
- Padrão de disjuntor
Implemente um disjuntor para evitar falhas em cascata:
Próximos passos
Referência da API
Lista completa de códigos de erro com explicações detalhadas.
Guia de Testes
Aprenda como testar cenários de erro em um ambiente de sandbox.
Contato de suporte
Obtenha ajuda para cenários de erro específicos.

