> ## Documentation Index
> Fetch the complete documentation index at: https://docs.malga.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 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ódigo 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 |

### Consulte a [tabela com os códigos de erro](/documentations/type-tables/declined-code) para o `error.declinedCode`