> ## Documentation Index
> Fetch the complete documentation index at: https://malga-develop.mintlify.site/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.

# Tabela de DeclinedCode da Malga

> Tabela com os códigos de recusa (declinedCode) retornados pela Malga, suas mensagens, retentabilidade e orientação ABECS para cada caso.

| DeclinedCode | ResponseMessage | Retentável | O que fazer (ABECS) |
| - | - | - | - |
| *authentication\_attempts\_unavailable\_by\_issuer* | Authentication attempts unavailable by issuer | Não | - |
| *authentication\_error* | Authentication Error | Não | - |
| *authentication\_error\_without\_challenge* | Authentication error without challenge | Não | - |
| *authentication\_unavailable* | Authentication Unavailable | Não | - |
| *bad\_request* | Request failed with status code 400 | Sim | VERIFIQUE OS DADOS |
| *blocked\_card* | Blocked Card | Sim | TRANSAÇÃO NÃO PERMITIDA PARA O CARTÃO - NÃO TENTE NOVAMENTE |
| *canceled\_card* | Canceled Card | Sim | TRANSAÇÃO NÃO PERMITIDA PARA O CARTÃO - NÃO TENTE NOVAMENTE |
| *card\_not\_supported* | The card does not support this type of purchase | Não | UTILIZE FUNÇÃO DÉBITO |
| *cardholder\_not\_complete\_authentication* | Cardholder did not complete authentication | Não | - |
| *denied\_reason\_not\_available* | The charge has been declined because the provider behaved unexpectedly and didn't sent a denied reason. | Sim | REFAZER A TRANSAÇÃO |
| *expired\_card* | The card expiration date is invalid | Sim | VERIFIQUE OS DADOS DO CARTÃO |
| *failed\_authentication* | Failed authentication eciRaw 07/00 | Não | - |
| *fraud\_confirmed* | The charge has been declined for confirmed fraud | Não | TRANSAÇÃO NÃO PERMITIDA PARA O CARTÃO - NÃO TENTE NOVAMENTE |
| *fraud\_suspect* | The charge has been declined for suspect it is fraudulent | Sim | CONTATE A CENTRAL DO SEU CARTÃO |
| *generic* | The card has been declined for a unknown reason | Sim | CONTATE A CENTRAL DO SEU CARTÃO |
| *insufficient\_funds* | The card has insufficient funds | Sim | NÃO AUTORIZADA |
| *internal\_error* | The charge has been declined for a unknown reason | Sim | REFAZER A TRANSAÇÃO |
| *invalid\_amount* | The charge amount is not valid or exceeded maximum allowed | Depende do provedor | VALOR DA TRANSAÇÃO NÃO PERMITIDO |
| *invalid\_credentials* | Invalid credentials | Sim | REFAZER A TRANSAÇÃO |
| *invalid\_cvv* | The security code is invalid | Sim | SENHA INVÁLIDA |
| *invalid\_data* | The card has been declined for invalid data | Não | VERIFIQUE OS DADOS DO CARTÃO |
| *invalid\_installment* | The charge has been declined because invalid number of installments | Sim | PARCELAMENTO INVÁLIDO |
| *invalid\_merchant* | The charge has been declined because merchant is not valid | Depende do provedor | CONTA ORIGEM INVÁLIDA |
| *invalid\_number* | The card number is invalid | Não | VERIFIQUE OS DADOS DO CARTÃO |
| *invalid\_pares* | Invalid PARes | Não | - |
| *invalid\_pin* | The card has been declined because pin is invalid | Não | SENHA INVÁLIDA |
| *issuer\_not\_available* | The card issuer could not be reached, charge not authorized | Sim | DADOS DO CARTÃO INVÁLIDO |
| *lost\_card* | The card has been declined because the card is reported lost | Não | TRANSAÇÃO NÃO PERMITIDA - NÃO TENTE NOVAMENTE |
| *maximum\_pin\_tries* | The card has been declined because pin validation has been exceeded | Depende do provedor | ERRO NO CARTÃO |
| *not\_permitted* | The charge is not permitted to the card | Sim | TRANSAÇÃO NÃO PERMITIDA PARA O CARTÃO |
| *pickup\_card* | The card cannot be used to make this charges | Sim | CONTATE A CENTRAL DO SEU CARTÃO |
| *pin\_try\_exceeded* | The card has been declined because exceeded maximum pin tries | Não | EXCEDIDAS TENTATIVAS DE SENHA. CONTATE A CENTRAL DO SEU CARTÃO |
| *processing\_error* | The charge has been declined for a unknown reason | Sim | REFAZER A TRANSAÇÃO |
| *request\_not\_sent* | The charge has been declined for a unknown reason | Sim | REFAZER A TRANSAÇÃO |
| *restricted\_card* | The card cannot be used to make this charge | Sim | DESBLOQUEIE O CARTÃO |
| *security\_violation* | The card has been declined for a unknown reason | Sim | VERIFIQUE OS DADOS DO CARTÃO |
| *service\_not\_allowed* | The card has been declined because do not support international charge | Não | CARTÃO NÃO PERMITE TRANSAÇÃO INTERNACIONAL |
| *stolen\_card* | The card has been declined because the card is reported stolen | Não | TRANSAÇÃO NÃO PERMITIDA - NÃO TENTE NOVAMENTE |
| *transaction\_not\_allowed* | The card has been declined for a unknown reason | Não | ERRO NO CARTÃO |
| *try\_again* | The card has been declined for a unknown reason | Sim | REFAZER A TRANSAÇÃO |
| *unable\_to\_perform\_authentication* | Issuer unable to perform authentication | Não | - |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.