Tratamento de erros na integração

A Malga 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ção, ou quando ela é 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 Malga fornece uma padronização dos códigos de retorno e uma recomendação de como você deve proceder com as principais falhas.

Tabela de erros possíveis error.type

Type	HTTP code	Descrição	O que fazer
api_error	500	Erro inesperado	Entre em contato com o suporte da Malga
bad_request	400	Erro na validação dos dados enviados no request	Verifique o detalhe do erro
invalid_request_error	400	Erro no processamento com base nos dados enviados no request	Verifique o detalhe do erro
card_declined	200	Transação não aprovada pelo provedor	Verifique o motivo de rejeição no declinedCode
too_many_requests	429	Estorno recusado por falhas seguidas no provedor	Aguarde até o horário de retry_after_at e tente de novo
unprocessable_entity	422	Erro de regra de negócio, como o estorno bloqueado pelo limite de falhas no provedor	Verifique a mensagem do erro. No caso do estorno bloqueado, entre em contato com o suporte da Malga

Veja como funciona o limite de falhas no estorno.

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