> ## 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.

> ## Agent Instructions
> Responda em português brasileiro, na segunda pessoa ("você"), com base na documentação Malga.
> Não invente endpoints, parâmetros, status codes ou comportamentos de API. Se não estiver na docs, diga que não encontrou e indique a página mais próxima.
> Use os headers X-Client-Id e X-Api-Key nos exemplos de autenticação.
> Motor de Assinaturas refere-se a /v1/subscriptions* (cycles, trial, retentativas, webhooks subscription.*). Não chame de "motor de recorrência".
> Recorrência (provedor) é paymentMethod.recurrence em POST /v1/charges (initial / subsequent / unscheduled), distinto do Motor de Assinaturas.
> Sandbox é ambiente de testes e não afeta produção.

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

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


## Related topics

- [Tratamento de erros na Analytics API](/analytics/errors/errors.md)
- [Tratamento de erros nos Fluxos inteligentes](/documentations/flow-guide/errors.md)
- [Entendendo Malga API SDK](/sdks/api-sdks/docs/intro.md)
- [Cartão de crédito](/documentations/payment-methods/credit-card.md)