Pular para o conteúdo principal

Tratamento de erros

A Plug disponibiliza uma lista de códigos de erro bem definida para facilitar a identificação dos diferentes tipos de problema que podem acontecer na integração.

Através desta especificação de erros é possível identificar os erros que acontecem quando uma requisição é processada com falha na autorizaçao, ou quando a é rejeitada por erro funcional. As categorias de erro HTTP possíveis são:

  • (2xx) não autorizado;
  • (4xx) problema no conteúdo da requisição;
  • (5xx) erro interno;
  • falha na comunicação ou timeout;

Código de retorno

Para transações não autorizadas que são recusadas pelo emissor a Plug fornece uma padronização dos código de retorno e uma recomendação de como você deve proceder com as principais falhas.

Tabela de erros possíveis error.type

TypeHTTP codeDescriçãoO que fazer
api_error500Erro inesperadoEntre em contato com o suporte da plug
bad_request400Erro na validação dos dados enviados no requestVerifique o detalhe do erro
invalid_request_error400Erro no processamento com base nos dados enviado requestVerifique o detalhe do erro
card_declined200Transação não aprovada pelo provedorVerifique o motivo de rejeição no declinedCode

Consulte a tabela com os códigos de erro para o error.declinedCode