Skip to main content

​
Visão geral

A API de pagamentos da Valora utiliza códigos de status HTTP padrão e códigos de erro personalizados para indicar o sucesso ou a falha das solicitações da API. Quando ocorre um erro, a API retorna um código de status HTTP apropriado e uma resposta JSON contendo informações detalhadas sobre o erro. Cada resposta de erro inclui:
  • Um código de status HTTP que indica a categoria geral do erro.
  • Um código de erro específico que identifica a natureza exata do erro.
  • Uma mensagem de erro legível para humanos explicando o que deu errado.
  • Detalhes adicionais sobre o erro, quando aplicável.
Compreender esses códigos de erro e seus significados é crucial para:
  • Depuração de problemas de integração
  • Implementar um tratamento de erros adequado em sua aplicação.
  • Fornecer feedback significativo aos usuários finais.
  • Manter um sistema robusto de processamento de pagamentos.
As seções a seguir fornecem informações detalhadas sobre os códigos de status HTTP padrão e os códigos de erro específicos que você pode encontrar ao usar a API de Pagamentos da Valora

​
Códigos de erro padrão da API

​
Formato da resposta de erro

Quando ocorre um erro, a API retorna uma resposta JSON com a seguinte estrutura:

​
Melhores práticas

  1. Em sua aplicação, sempre lide com erros de forma adequada.
  2. Implemente um sistema de registro de erros adequado.
  3. Utilize mensagens de erro apropriadas para os usuários finais.
  4. Implemente uma lógica de repetição para erros transitórios.
  5. Contate o suporte para problemas não resolvidos.