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

# Motivos de Recusa

> Lista todos os códigos e descrições de recusa de pagamento

Retorna o catálogo completo de motivos de recusa de pagamento, com o código, a
descrição localizada e a categoria de cada um. Use esta lista para traduzir o
código de recusa retornado em um pagamento negado em uma mensagem amigável para
o cliente ou para tratamento programático (retry, troca de cartão, etc.).

<Note>
  As descrições são retornadas no idioma configurado nas preferências do seu
  estabelecimento (`merchantSetting.language`).
</Note>

## Exemplos de Requisição

<CodeGroup>
  ```bash cURL theme={null}
  curl -X GET https://pay.autorizou.dev/api/v1/refusal-reasons \
      -H "Authorization: Bearer 4eC39HqLyjWDarjtT1zdp7dc"
  ```

  ```javascript JavaScript theme={null}
  const result = await fetch('https://pay.autorizou.dev/api/v1/refusal-reasons', {
    headers: { 'Authorization': 'Bearer 4eC39HqLyjWDarjtT1zdp7dc' }
  });

  console.log('Motivos de recusa:', await result.json());
  ```

  ```php PHP theme={null}
  <?php

  $curl = curl_init();
  curl_setopt_array($curl, [
      CURLOPT_URL => 'https://pay.autorizou.dev/api/v1/refusal-reasons',
      CURLOPT_RETURNTRANSFER => true,
      CURLOPT_HTTPHEADER => ['Authorization: Bearer 4eC39HqLyjWDarjtT1zdp7dc'],
  ]);

  $response = json_decode(curl_exec($curl), true);
  echo json_encode($response, JSON_PRETTY_PRINT);
  ?>
  ```
</CodeGroup>

## Estrutura da Resposta

<ResponseField name="code" type="string">
  Código do motivo de recusa (padrão de bandeira/adquirente).
</ResponseField>

<ResponseField name="description" type="string">
  Descrição localizada do motivo de recusa.
</ResponseField>

<ResponseField name="category" type="string">
  Categoria do erro (ex.: recusa do emissor, dados inválidos, fraude).
</ResponseField>

## Exemplo de Resposta

```json theme={null}
[
  {
    "code": "01",
    "description": "Entre em contato com o emissor do cartão",
    "category": "Recusa do emissor"
  },
  {
    "code": "14",
    "description": "Número do cartão inválido",
    "category": "Dados inválidos"
  },
  {
    "code": "57",
    "description": "Transação não permitida para este portador",
    "category": "Recusa do emissor"
  }
]
```