Pular para o conteúdo principal
O tratamento eficaz de erros é crucial para a criação de integrações robustas com a API Localpayment. Compreender os diferentes tipos de erros e seus respectivos códigos ajudará você a diagnosticar problemas rapidamente e a implementar soluções adequadas. Oferecemos um tratamento de erros abrangente por meio de códigos de status HTTP padronizados e respostas de erro detalhadas. Este guia mostra como você pode lidar com erros de forma eficaz para criar uma integração mais resiliente e fácil de usar.

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 campos status.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.

  1. Implementar registro abrangente de logs

  1. Mensagens de erro fáceis de usar

Crie um mapeamento de códigos de erro técnicos para mensagens amigáveis ao usuário:

  1. Mecanismo de Repetição com Recuo Exponencial

  1. 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.
Última modificação em 10 de novembro de 2026