---
updatedAt: 2026-09-04T13:35:57.000Z
agentTools:
  siteIndex: https://docs.cielo.com.br/llms.txt
  projectIndex: https://docs.cielo.com.br/gateway/llms.txt
---

# Códigos de retorno de negócio da API (Provider e Reason)

Para saber se uma venda foi autorizada e/ou paga, confira o `Payment.Status`, e o `ProviderReturnCode` e `ProviderReturnMessage`.

> Os códigos retornados são dinâmicos e dependem do fluxo percorrido por cada solicitação.

***

Veja nesta seção:

* [Códigos de retorno do provedor](https://docs.cielo.com.br/gateway/reference/api-codes#c%C3%B3digos-de-retorno-do-provedor-providerreturncode-e-providerreturnmessage): `ProviderReturnCode` e `ProviderReturnMessage`;
* [Códigos de motivo](https://docs.cielo.com.br/gateway/reference/api-codes#c%C3%B3digos-de-motivo-reasoncode-e-reasonmessage): `ReasonCode` e `ReasonMessage`.

***

## Códigos de retorno do provedor: `ProviderReturnCode` e `ProviderReturnMessage`

O `ProviderReturnCode` e `ProviderReturnMessage` fornecem o resultado da operação do ponto de vista do negócio, retornado pelo provedor/adquirente, e são apresentados no corpo da resposta para as seguintes operações:

* Criação de transações;
* Captura;
* Cancelamento;
* Devolução de Pix;
* Conversão de moedas;
* Criação de pagamento com boleto.

<Callout icon="⚠️" theme="warn">
  Os valores de `ProviderReturnCode` e `ProviderReturnMessage` apresentados a seguir são os retornados quando o provedor/adquirente da transação é a **Cielo**.

  &#x20;Caso o estabelecimento utilize outra adquirente integrada ao Gateway, os códigos e mensagens serão os definidos por ela — consulte a documentação da adquirente utilizada para a lista completa.
</Callout>

Os principais `ProviderReturnCode` de sucesso (para adquirente Cielo) são:

* `00`: transação autorizada;
* `4`: transação autorizada (apta a ser capturada);
* `6`: transação capturada.

<Callout icon="ℹ️" theme="info">
  Valide o sucesso da venda pela combinação do `ProviderReturnCode` com o `Payment.Status`.
</Callout>

Alguns exemplos de `ProviderReturnCode` de transações negadas (adquirente Cielo) são:

* `51`: o portador do cartão não tem saldo suficiente para a compra;
* `54`: cartão vencido;
* `78`: cartão novo sem desbloqueio.

### Como interpretar o `ProviderReturnCode`

Quando uma transação é negada, o `ProviderReturnCode` é a base para determinar o fluxo de decisão. É importante que o estabelecimento analise se o retorno é reversível ou irreversível e decida por submeter ou não a transação para uma nova tentativa de autorização.

Analise o tipo de retorno para:

* Determinar se a transação pode ser enviada novamente para o mesmo cartão;

* Criar mensagens na página de pagamento ou enviar mensagem ao comprador orientando a usar outro cartão ou outro meio de pagamento.

<Callout icon="ℹ️" theme="info">
  ### Atenção para autorizações negadas de cartão de crédito ou débito:

  **Quando a transação é reversível:**

  - Envie a transação novamente para autorização (retentativa);
  - Respeite o limite de retentativas da bandeira para aquele código e evite penalidades.

  **Quando a transação é irreversível:**

  - Oriente o comprador a tentar outro cartão ou meio de pagamento.
</Callout>

<br />

***

### Cenários comuns de `ProviderReturnCode` por meio de pagamento

A tabela a seguir exemplifica os principais cenários por meio de pagamento, com o seu `Status` e `ProviderReturnCode` correspondentes (valores para adquirente Cielo):

| Cenário                        | `Payment.Status` | Exemplo\* de `ProviderReturnCode`                                                   | Exemplo\* `ProviderReturnMessage`                         |
| ------------------------------ | ---------------- | ----------------------------------------------------------------------------------- | --------------------------------------------------------- |
| Crédito - autorizado           | 1                | 00 ou 4                                                                             | *Transação autorizada*                                    |
| Crédito - capturado (pago)     | 2                | 6 ou 00                                                                             | *Transação capturada com sucesso*                         |
| Crédito - negado               | 3                | Diversos (ver [tabela Abecs](https://docs.cielo.com.br/ecommerce-cielo/page/abecs)) | Autorização negada                                        |
| Crédito - abortado             | 13               | —                                                                                   | Não retorna `ProviderReturnCode`/`ProviderReturnMessage`  |
| Crédito - não finalizado       | 0                | 001 ou BP171                                                                        | *XML inválido* or *Rejected by fraud risk*                |
| Crédito - recorrência agendada | 20               | 4                                                                                   | *Operation Successful*                                    |
| Débito - pago                  | 2                | 00 ou 6                                                                             | *Transação capturada com sucesso*                         |
| Débito - não autorizado        | 3                | Diversos (ver tabela Abecs)                                                         | *Autorização negada*                                      |
| Pix - gerado com sucesso       | 12               | 0                                                                                   | *Pix gerado com sucesso*                                  |
| Pix - pago                     | 2                | 0                                                                                   | *Sucesso*                                                 |
| Pix - não finalizado           | 0                | 422                                                                                 | *Error on merchantResponse integration*                   |
| Pix - devolvido                | 11               | 0                                                                                   | *Devolução solicitada com sucesso*                        |
| Boleto - criado                | 1                | 0                                                                                   | *REGISTRO EFETUADO COM SUCESSO*                           |
| Boleto pago                    | 2                | --                                                                                  | --                                                        |
| Cancelamento aprovado          | 10               | 9                                                                                   | *Transação desfeita* ou *Transação cancelada com sucesso* |
| Estorno aprovado               | 11               | 9                                                                                   | *Transação desfeita*                                      |

> \*Os valores de `ProviderReturnCode` e `ProviderReturnMessage` apresentados na tabela são exemplos de retornos comuns para cada cenário **quando o provedor/adquirente é a Cielo**. Se o estabelecimento utiliza outra adquirente, consulte a documentação dessa adquirente.

<br />

### Tabela de `ProviderReturnCode` e `ProviderReturnMessage` (adquirente Cielo)

`ProviderReturnCode` e `ProviderReturnMessage` apresentam os mesmos valores de `Code` e `Message`, mas retornam em situações diferentes:

* Os valores `ProviderReturnCode` e `ProviderReturnMessage` são retornados em operações HTTP de sucesso (200 ou 201);
* Os valores `Code` e `Message` são retornados em operações HTTP de erro (ex.: 400).

<Callout icon="⚠️" theme="warn">
  A tabela abaixo lista os códigos e mensagens específicos da adquirente **Cielo**.&#x20;

  Se o estabelecimento utiliza outra adquirente integrada ao Gateway, os códigos e mensagens de `ProviderReturnCode`/`ProviderReturnMessage` serão diferentes — consulte a documentação da adquirente utilizada.
</Callout>

Confira a tabela completa:

<Table align={["left","left","left"]}>
  <thead>
    <tr>
      <th>
        Provider Return Code
      </th>

      <th>
        Provider Return Message
      </th>

      <th>
        Descrição
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        0
      </td>

      <td>
        Internal error
      </td>

      <td>
        Dado enviado excede o tamanho do campo.
      </td>
    </tr>

    <tr>
      <td>
        100
      </td>

      <td>
        RequestId is required
      </td>

      <td>
        Campo enviado está vazio ou inválido.
      </td>
    </tr>

    <tr>
      <td>
        101
      </td>

      <td>
        MerchantId is required
      </td>

      <td>
        Campo enviado está vazio ou inválido.
      </td>
    </tr>

    <tr>
      <td>
        102
      </td>

      <td>
        Payment Type is required
      </td>

      <td>
        Campo enviado está vazio ou inválido.
      </td>
    </tr>

    <tr>
      <td>
        103
      </td>

      <td>
        Payment Type can only contain letters
      </td>

      <td>
        Caracteres especiais não permitidos.
      </td>
    </tr>

    <tr>
      <td>
        104
      </td>

      <td>
        Customer Identity is required
      </td>

      <td>
        Campo enviado está vazio ou inválido.
      </td>
    </tr>

    <tr>
      <td>
        105
      </td>

      <td>
        Customer Name is required
      </td>

      <td>
        Campo enviado está vazio ou inválido.
      </td>
    </tr>

    <tr>
      <td>
        106
      </td>

      <td>
        Transaction ID is required
      </td>

      <td>
        Campo enviado está vazio ou inválido.
      </td>
    </tr>

    <tr>
      <td>
        107
      </td>

      <td>
        OrderId is invalid or does not exist
      </td>

      <td>
        Campo enviado excede o tamanho ou contém caracteres especiais.
      </td>
    </tr>

    <tr>
      <td>
        108
      </td>

      <td>
        Amount must be greater or equal to zero
      </td>

      <td>
        Valor da transação deve ser maior que "0".
      </td>
    </tr>

    <tr>
      <td>
        109
      </td>

      <td>
        Payment Currency is required
      </td>

      <td>
        Campo enviado está vazio ou inválido.
      </td>
    </tr>

    <tr>
      <td>
        110
      </td>

      <td>
        Invalid Payment Currency
      </td>

      <td>
        Campo enviado está vazio ou inválido.
      </td>
    </tr>

    <tr>
      <td>
        111
      </td>

      <td>
        Payment Country is required
      </td>

      <td>
        Campo enviado está vazio ou inválido.
      </td>
    </tr>

    <tr>
      <td>
        112
      </td>

      <td>
        Invalid Payment Country
      </td>

      <td>
        Campo enviado está vazio ou inválido.
      </td>
    </tr>

    <tr>
      <td>
        113
      </td>

      <td>
        Invalid Payment Code
      </td>

      <td>
        Campo enviado está vazio ou inválido.
      </td>
    </tr>

    <tr>
      <td>
        114
      </td>

      <td>
        The provided MerchantId is not in correct format
      </td>

      <td>
        O MerchantId enviado não é um GUID.
      </td>
    </tr>

    <tr>
      <td>
        115
      </td>

      <td>
        The provided MerchantId was not found
      </td>

      <td>
        O MerchantID não existe ou pertence a outro ambiente. (Ex.: Sandbox).
      </td>
    </tr>

    <tr>
      <td>
        116
      </td>

      <td>
        The provided MerchantId is blocked
      </td>

      <td>
        Loja bloqueada, entre em contato com o <a href="https://docs.cielo.com.br/atendimento/docs/atendimento-cielo-braspag" target="_blank">suporte e-commerce.</a>
      </td>
    </tr>

    <tr>
      <td>
        117
      </td>

      <td>
        Credit Card Holder is required
      </td>

      <td>
        Campo enviado está vazio ou inválido.
      </td>
    </tr>

    <tr>
      <td>
        118
      </td>

      <td>
        Credit Card Number is required
      </td>

      <td>
        Campo enviado está vazio ou inválido.
      </td>
    </tr>

    <tr>
      <td>
        119
      </td>

      <td>
        At least one Payment is required
      </td>

      <td>
        Nó `Payment` não enviado.
      </td>
    </tr>

    <tr>
      <td>
        120
      </td>

      <td>
        Request IP not allowed. Check your IP White List
      </td>

      <td>
        IP bloqueado por questões de segurança.
      </td>
    </tr>

    <tr>
      <td>
        121
      </td>

      <td>
        Customer is required
      </td>

      <td>
        Nó `Customer` não enviado.
      </td>
    </tr>

    <tr>
      <td>
        122
      </td>

      <td>
        MerchantOrderId is required
      </td>

      <td>
        Campo enviado está vazio ou inválido.
      </td>
    </tr>

    <tr>
      <td>
        123
      </td>

      <td>
        Installments must be greater or equal to one
      </td>

      <td>
        Número de parcelas deve ser superior a 1.
      </td>
    </tr>

    <tr>
      <td>
        124
      </td>

      <td>
        Credit Card is Required
      </td>

      <td>
        Campo enviado está vazio ou inválido.
      </td>
    </tr>

    <tr>
      <td>
        125
      </td>

      <td>
        Credit Card Expiration Date is required
      </td>

      <td>
        Campo enviado está vazio ou inválido.
      </td>
    </tr>

    <tr>
      <td>
        126
      </td>

      <td>
        Credit Card Expiration Date is invalid
      </td>

      <td>
        Campo enviado está vazio ou inválido.
      </td>
    </tr>

    <tr>
      <td>
        127
      </td>

      <td>
        You must provide CreditCard Number
      </td>

      <td>
        Número do cartão de crédito é obrigatório.
      </td>
    </tr>

    <tr>
      <td>
        128
      </td>

      <td>
        Card Number length exceeded
      </td>

      <td>
        Número do cartão superior a 16 dígitos.
      </td>
    </tr>

    <tr>
      <td>
        129
      </td>

      <td>
        Affiliation not found
      </td>

      <td>
        Meio de pagamento não vinculado à loja ou Provider inválido.
      </td>
    </tr>

    <tr>
      <td>
        130
      </td>

      <td>
        Could not get Credit Card
      </td>

      <td>

      </td>
    </tr>

    <tr>
      <td>
        131
      </td>

      <td>
        MerchantKey is required
      </td>

      <td>
        Campo enviado está vazio ou inválido.
      </td>
    </tr>

    <tr>
      <td>
        132
      </td>

      <td>
        MerchantKey is invalid
      </td>

      <td>
        O Merchantkey enviado não é válido.
      </td>
    </tr>

    <tr>
      <td>
        133
      </td>

      <td>
        Provider is not supported for this Payment Type
      </td>

      <td>
        Provider enviado não existe.
      </td>
    </tr>

    <tr>
      <td>
        134
      </td>

      <td>
        FingerPrint length exceeded
      </td>

      <td>
        Dado enviado excede o tamanho do campo.
      </td>
    </tr>

    <tr>
      <td>
        135
      </td>

      <td>
        MerchantDefinedFieldValue length exceeded
      </td>

      <td>
        Dado enviado excede o tamanho do campo.
      </td>
    </tr>

    <tr>
      <td>
        136
      </td>

      <td>
        ItemDataName length exceeded
      </td>

      <td>
        Dado enviado excede o tamanho do campo.
      </td>
    </tr>

    <tr>
      <td>
        137
      </td>

      <td>
        ItemDataSKU length exceeded
      </td>

      <td>
        Dado enviado excede o tamanho do campo.
      </td>
    </tr>

    <tr>
      <td>
        138
      </td>

      <td>
        PassengerDataName length exceeded
      </td>

      <td>
        Dado enviado excede o tamanho do campo.
      </td>
    </tr>

    <tr>
      <td>
        139
      </td>

      <td>
        PassengerDataStatus length exceeded
      </td>

      <td>
        Dado enviado excede o tamanho do campo.
      </td>
    </tr>

    <tr>
      <td>
        140
      </td>

      <td>
        PassengerDataEmail length exceeded
      </td>

      <td>
        Dado enviado excede o tamanho do campo.
      </td>
    </tr>

    <tr>
      <td>
        141
      </td>

      <td>
        PassengerDataPhone length exceeded
      </td>

      <td>
        Dado enviado excede o tamanho do campo.
      </td>
    </tr>

    <tr>
      <td>
        142
      </td>

      <td>
        TravelDataRoute length exceeded
      </td>

      <td>
        Dado enviado excede o tamanho do campo.
      </td>
    </tr>

    <tr>
      <td>
        143
      </td>

      <td>
        TravelDataJourneyType length exceeded
      </td>

      <td>
        Dado enviado excede o tamanho do campo.
      </td>
    </tr>

    <tr>
      <td>
        144
      </td>

      <td>
        TravelLegDataDestination length exceeded
      </td>

      <td>
        Dado enviado excede o tamanho do campo.
      </td>
    </tr>

    <tr>
      <td>
        145
      </td>

      <td>
        TravelLegDataOrigin length exceeded
      </td>

      <td>
        Dado enviado excede o tamanho do campo.
      </td>
    </tr>

    <tr>
      <td>
        146
      </td>

      <td>
        SecurityCode length exceeded
      </td>

      <td>
        Dado enviado excede o tamanho do campo.
      </td>
    </tr>

    <tr>
      <td>
        147
      </td>

      <td>
        Address Street length exceeded
      </td>

      <td>
        Dado enviado excede o tamanho do campo.
      </td>
    </tr>

    <tr>
      <td>
        148
      </td>

      <td>
        Address Number length exceeded
      </td>

      <td>
        Dado enviado excede o tamanho do campo.
      </td>
    </tr>

    <tr>
      <td>
        149
      </td>

      <td>
        Address Complement length exceeded
      </td>

      <td>
        Dado enviado excede o tamanho do campo.
      </td>
    </tr>

    <tr>
      <td>
        150
      </td>

      <td>
        Address ZipCode length exceeded
      </td>

      <td>
        Dado enviado excede o tamanho do campo.
      </td>
    </tr>

    <tr>
      <td>
        151
      </td>

      <td>
        Address City length exceeded
      </td>

      <td>
        Dado enviado excede o tamanho do campo.
      </td>
    </tr>

    <tr>
      <td>
        152
      </td>

      <td>
        Address State length exceeded
      </td>

      <td>
        Dado enviado excede o tamanho do campo.
      </td>
    </tr>

    <tr>
      <td>
        153
      </td>

      <td>
        Address Country length exceeded
      </td>

      <td>
        Dado enviado excede o tamanho do campo.
      </td>
    </tr>

    <tr>
      <td>
        154
      </td>

      <td>
        Address District length exceeded
      </td>

      <td>
        Dado enviado excede o tamanho do campo.
      </td>
    </tr>

    <tr>
      <td>
        155
      </td>

      <td>
        Customer Name length exceeded
      </td>

      <td>
        Dado enviado excede o tamanho do campo.
      </td>
    </tr>

    <tr>
      <td>
        156
      </td>

      <td>
        Customer Identity length exceeded
      </td>

      <td>
        Dado enviado excede o tamanho do campo.
      </td>
    </tr>

    <tr>
      <td>
        157
      </td>

      <td>
        Customer IdentityType length exceeded
      </td>

      <td>
        Dado enviado excede o tamanho do campo.
      </td>
    </tr>

    <tr>
      <td>
        158
      </td>

      <td>
        Customer Email length exceeded
      </td>

      <td>
        Dado enviado excede o tamanho do campo.
      </td>
    </tr>

    <tr>
      <td>
        159
      </td>

      <td>
        ExtraData Name length exceeded
      </td>

      <td>
        Dado enviado excede o tamanho do campo.
      </td>
    </tr>

    <tr>
      <td>
        160
      </td>

      <td>
        ExtraData Value length exceeded
      </td>

      <td>
        Dado enviado excede o tamanho do campo.
      </td>
    </tr>

    <tr>
      <td>
        161
      </td>

      <td>
        Boleto Instructions length exceeded
      </td>

      <td>
        Dado enviado excede o tamanho do campo.
      </td>
    </tr>

    <tr>
      <td>
        162
      </td>

      <td>
        Boleto Demostrative length exceeded
      </td>

      <td>
        Dado enviado excede o tamanho do campo.
      </td>
    </tr>

    <tr>
      <td>
        163
      </td>

      <td>
        Return Url is required
      </td>

      <td>
        URL de retorno não é valida - Não são aceitas paginação ou extensões (EX.: PHP) na URL de retorno.
      </td>
    </tr>

    <tr>
      <td>
        166
      </td>

      <td>
        AuthorizeNow is required
      </td>

      <td>

      </td>
    </tr>

    <tr>
      <td>
        167
      </td>

      <td>
        Antifraud not configured
      </td>

      <td>
        Antifraude não vinculado ao cadastro do lojista.
      </td>
    </tr>

    <tr>
      <td>
        168
      </td>

      <td>
        Recurrent Payment not found
      </td>

      <td>
        Recorrência não encontrada.
      </td>
    </tr>

    <tr>
      <td>
        169
      </td>

      <td>
        Recurrent Payment is not active
      </td>

      <td>
        Recorrência não está ativa. Execução paralizada.
      </td>
    </tr>

    <tr>
      <td>
        170
      </td>

      <td>
        Cartão Protegido not configured
      </td>

      <td>
        Cartão protegido não vinculado ao cadastro do lojista.
      </td>
    </tr>

    <tr>
      <td>
        171
      </td>

      <td>
        Affiliation data not sent
      </td>

      <td>
        Falha no processamento do pedido, entre em contato com o <a href="https://docs.cielo.com.br/atendimento/docs/atendimento-cielo-braspag" target="_blank">suporte e-commerce.</a>
      </td>
    </tr>

    <tr>
      <td>
        172
      </td>

      <td>
        Credential Code is required
      </td>

      <td>
        Falha na validação das credenciadas enviadas.
      </td>
    </tr>

    <tr>
      <td>
        173
      </td>

      <td>
        Payment method is not enabled
      </td>

      <td>
        Meio de pagamento não vinculado ao cadastro do lojista.
      </td>
    </tr>

    <tr>
      <td>
        174
      </td>

      <td>
        Card Number is required
      </td>

      <td>
        Campo enviado está vazio ou inválido.
      </td>
    </tr>

    <tr>
      <td>
        175
      </td>

      <td>
        EAN is required
      </td>

      <td>
        Campo enviado está vazio ou inválido.
      </td>
    </tr>

    <tr>
      <td>
        176
      </td>

      <td>
        Payment Currency is not supported
      </td>

      <td>
        Campo enviado está vazio ou inválido.
      </td>
    </tr>

    <tr>
      <td>
        177
      </td>

      <td>
        Card Number is invalid
      </td>

      <td>
        Campo enviado está vazio ou inválido.
      </td>
    </tr>

    <tr>
      <td>
        178
      </td>

      <td>
        EAN is invalid
      </td>

      <td>
        Campo enviado está vazio ou inválido.
      </td>
    </tr>

    <tr>
      <td>
        179
      </td>

      <td>
        The max number of installments allowed for recurring payment is 1
      </td>

      <td>
        Campo enviado está vazio ou inválido.
      </td>
    </tr>

    <tr>
      <td>
        180
      </td>

      <td>
        The provided Card PaymentToken was not found
      </td>

      <td>
        Token do cartão protegido não encontrado.
      </td>
    </tr>

    <tr>
      <td>
        181
      </td>

      <td>
        The MerchantIdJustClick is not configured
      </td>

      <td>
        Token do cartão protegido bloqueado.
      </td>
    </tr>

    <tr>
      <td>
        182
      </td>

      <td>
        Brand is required
      </td>

      <td>
        Bandeira do cartão não enviado.
      </td>
    </tr>

    <tr>
      <td>
        183
      </td>

      <td>
        Invalid customer bithdate
      </td>

      <td>
        Data de nascimento inválida ou futura.
      </td>
    </tr>

    <tr>
      <td>
        184
      </td>

      <td>
        Request could not be empty
      </td>

      <td>
        Falha no formato da requisição. Verifique o código enviado.
      </td>
    </tr>

    <tr>
      <td>
        185
      </td>

      <td>
        Brand is not supported by selected provider
      </td>

      <td>
        Bandeira não suportada pela API Gateway de Pagamento.
      </td>
    </tr>

    <tr>
      <td>
        186
      </td>

      <td>
        The selected provider does not support the options provided (Capture, Authenticate, Recurrent or Installments)
      </td>

      <td>
        Meio de pagamento não suporta o comando enviado.
      </td>
    </tr>

    <tr>
      <td>
        187
      </td>

      <td>
        ExtraData Collection contains one or more duplicated names
      </td>

      <td>

      </td>
    </tr>

    <tr>
      <td>
        188
      </td>

      <td>
        Avs with CPF invalid
      </td>

      <td>

      </td>
    </tr>

    <tr>
      <td>
        189
      </td>

      <td>
        Avs with length of street exceeded
      </td>

      <td>
        Dado enviado excede o tamanho do campo.
      </td>
    </tr>

    <tr>
      <td>
        190
      </td>

      <td>
        Avs with length of number exceeded
      </td>

      <td>
        Dado enviado excede o tamanho do campo.
      </td>
    </tr>

    <tr>
      <td>
        190
      </td>

      <td>
        Avs with length of complement exceeded
      </td>

      <td>
        Dado enviado excede o tamanho do campo.
      </td>
    </tr>

    <tr>
      <td>
        191
      </td>

      <td>
        Avs with length of district exceeded
      </td>

      <td>
        Dado enviado excede o tamanho do campo.
      </td>
    </tr>

    <tr>
      <td>
        192
      </td>

      <td>
        Avs with zip code invalid
      </td>

      <td>
        CEP enviado é inválido.
      </td>
    </tr>

    <tr>
      <td>
        193
      </td>

      <td>
        Split Amount must be greater than zero
      </td>

      <td>
        Valor para realização do SPLIT deve ser superior a 0.
      </td>
    </tr>

    <tr>
      <td>
        194
      </td>

      <td>
        Split Establishment is Required
      </td>

      <td>
        SPLIT não habilitado para o cadastro da loja.
      </td>
    </tr>

    <tr>
      <td>
        195
      </td>

      <td>
        PlatformId is required
      </td>

      <td>
        Validados de plataformas não enviado.
      </td>
    </tr>

    <tr>
      <td>
        196
      </td>

      <td>
        DeliveryAddress is required
      </td>

      <td>
        Campo obrigatório não enviado.
      </td>
    </tr>

    <tr>
      <td>
        197
      </td>

      <td>
        Street is required
      </td>

      <td>
        Campo obrigatório não enviado.
      </td>
    </tr>

    <tr>
      <td>
        198
      </td>

      <td>
        Number is required
      </td>

      <td>
        Campo obrigatório não enviado.
      </td>
    </tr>

    <tr>
      <td>
        199
      </td>

      <td>
        ZipCode is required
      </td>

      <td>
        Campo obrigatório não enviado.
      </td>
    </tr>

    <tr>
      <td>
        200
      </td>

      <td>
        City is required
      </td>

      <td>
        Campo obrigatório não enviado.
      </td>
    </tr>

    <tr>
      <td>
        201
      </td>

      <td>
        State is required
      </td>

      <td>
        Campo obrigatório não enviado.
      </td>
    </tr>

    <tr>
      <td>
        202
      </td>

      <td>
        District is required
      </td>

      <td>
        Campo obrigatório não enviado.
      </td>
    </tr>

    <tr>
      <td>
        203
      </td>

      <td>
        Cart item name is required
      </td>

      <td>
        Campo obrigatório não enviado.
      </td>
    </tr>

    <tr>
      <td>
        204
      </td>

      <td>
        Cart item quantity is required
      </td>

      <td>
        Campo obrigatório não enviado.
      </td>
    </tr>

    <tr>
      <td>
        205
      </td>

      <td>
        Cart item type is required
      </td>

      <td>
        Campo obrigatório não enviado.
      </td>
    </tr>

    <tr>
      <td>
        206
      </td>

      <td>
        Cart item name length exceeded
      </td>

      <td>
        Dado enviado excede o tamanho do campo.
      </td>
    </tr>

    <tr>
      <td>
        207
      </td>

      <td>
        Cart item description length exceeded
      </td>

      <td>
        Dado enviado excede o tamanho do campo.
      </td>
    </tr>

    <tr>
      <td>
        208
      </td>

      <td>
        Cart item sku length exceeded
      </td>

      <td>
        Dado enviado excede o tamanho do campo.
      </td>
    </tr>

    <tr>
      <td>
        209
      </td>

      <td>
        Shipping addressee sku length exceeded
      </td>

      <td>
        Dado enviado excede o tamanho do campo.
      </td>
    </tr>

    <tr>
      <td>
        210
      </td>

      <td>
        Shipping data cannot be null
      </td>

      <td>
        Campo obrigatório não enviado.
      </td>
    </tr>

    <tr>
      <td>
        213
      </td>

      <td>
        Credit Card Number is invalid
      </td>

      <td>
        Cartão de crédito enviado é invalido.
      </td>
    </tr>

    <tr>
      <td>
        214
      </td>

      <td>
        Credit Card Holder Must Have Only Letters
      </td>

      <td>
        Portador do cartão não deve conter caracteres especiais.
      </td>
    </tr>

    <tr>
      <td>
        215
      </td>

      <td>
        Agency is required in Boleto Credential
      </td>

      <td>
        Campo obrigatório não enviado.
      </td>
    </tr>

    <tr>
      <td>
        216
      </td>

      <td>
        Customer IP address is invalid
      </td>

      <td>
        IP bloqueado por questões de segurança.
      </td>
    </tr>

    <tr>
      <td>
        220
      </td>

      <td>
        Service tax can not be sent with 1 installment
      </td>

      <td>
        `ServiceTaxAmount` precisa de parcelamento superior a 1.
      </td>
    </tr>

    <tr>
      <td>
        228
      </td>

      <td>
        Customer Anddress Country is required
      </td>

      <td>
        Campo enviado está vazio ou inválido
      </td>
    </tr>

    <tr>
      <td>
        233
      </td>

      <td>
        Service tax not supported for the given brand
      </td>

      <td>
        `ServiceTaxAmount` não suportado pela bandeira do cartão.
      </td>
    </tr>

    <tr>
      <td>
        298
      </td>

      <td>
        Split payment facilitator data not found.
      </td>

      <td>
        O `MerchantId` informado não existe na base de dados do ambiente selecionado (Produção ou Sandbox)
      </td>
    </tr>

    <tr>
      <td>
        300
      </td>

      <td>
        MerchantId was not found
      </td>

      <td>

      </td>
    </tr>

    <tr>
      <td>
        301
      </td>

      <td>
        Request IP is not allowed
      </td>

      <td>

      </td>
    </tr>

    <tr>
      <td>
        302
      </td>

      <td>
        Sent MerchantOrderId is duplicated
      </td>

      <td>
        Houve duplicidade do pedido.
      </td>
    </tr>

    <tr>
      <td>
        303
      </td>

      <td>
        Sent OrderId does not exist
      </td>

      <td>

      </td>
    </tr>

    <tr>
      <td>
        304
      </td>

      <td>
        Customer Identity is required
      </td>

      <td>

      </td>
    </tr>

    <tr>
      <td>
        306
      </td>

      <td>
        Merchant is blocked
      </td>

      <td>

      </td>
    </tr>

    <tr>
      <td>
        307
      </td>

      <td>
        Transaction not found
      </td>

      <td>
        Transação não encontrada ou não existente no ambiente.
      </td>
    </tr>

    <tr>
      <td>
        308
      </td>

      <td>
        Transaction not available to capture
      </td>

      <td>
        Transação não pode ser capturada - Entre em contato com o <a href="https://docs.cielo.com.br/atendimento/docs/atendimento-cielo-braspag" target="_blank">suporte e-commerce.</a>

        - Verificar se o valor informado é inferior ao valor total da transação ou se está disponível para captura
      </td>
    </tr>

    <tr>
      <td>
        309
      </td>

      <td>
        Transaction not available to void
      </td>

      <td>
        Transação não pode ser cancelada - Entre em contato com o <a href="https://docs.cielo.com.br/atendimento/docs/atendimento-cielo-braspag" target="_blank">suporte e-commerce.</a>
      </td>
    </tr>

    <tr>
      <td>
        310
      </td>

      <td>
        Payment method does not support this operation
      </td>

      <td>
        Comando enviado não suportado pelo meio de pagamento.
      </td>
    </tr>

    <tr>
      <td>
        311
      </td>

      <td>
        Refund is not enabled for this merchant
      </td>

      <td>
        Cancelamento após 24 horas não liberado para o lojista.
      </td>
    </tr>

    <tr>
      <td>
        312
      </td>

      <td>
        Transaction not available to refund
      </td>

      <td>
        Transação não permite cancelamento após 24 horas.
      </td>
    </tr>

    <tr>
      <td>
        313
      </td>

      <td>
        Recurrent Payment not found
      </td>

      <td>
        Transação recorrente não encontrada ou não disponivel no ambiente.
      </td>
    </tr>

    <tr>
      <td>
        314
      </td>

      <td>
        Invalid Integration
      </td>

      <td>

      </td>
    </tr>

    <tr>
      <td>
        315
      </td>

      <td>
        Cannot change NextRecurrency with pending payment
      </td>

      <td>

      </td>
    </tr>

    <tr>
      <td>
        316
      </td>

      <td>
        Cannot set NextRecurrency to past date
      </td>

      <td>
        Não é permitido alterar a data da recorrência para uma data passada.
      </td>
    </tr>

    <tr>
      <td>
        317
      </td>

      <td>
        Invalid Recurrency Day
      </td>

      <td>

      </td>
    </tr>

    <tr>
      <td>
        318
      </td>

      <td>
        No transaction found
      </td>

      <td>

      </td>
    </tr>

    <tr>
      <td>
        319
      </td>

      <td>
        Smart Recurrency is not enabled
      </td>

      <td>
        Recorrência não vinculada ao cadastro do lojista.
      </td>
    </tr>

    <tr>
      <td>
        320
      </td>

      <td>
        Cannot Update Affiliation because this recurrency has no affiliation saved
      </td>

      <td>

      </td>
    </tr>

    <tr>
      <td>
        321
      </td>

      <td>
        Cannot Set EndDate to before next recurrency
      </td>

      <td>

      </td>
    </tr>

    <tr>
      <td>
        322
      </td>

      <td>
        Zero Dollar Auth is not enabled
      </td>

      <td>
        Zero Dollar não vinculado ao cadastro do lojista.
      </td>
    </tr>

    <tr>
      <td>
        323
      </td>

      <td>
        Bin Query is not enabled
      </td>

      <td>
        Consulta de Bins não vinculada ao cadastro do lojista.
      </td>
    </tr>

    <tr>
      <td>
        841
      </td>

      <td>
        Status nao permite capturar
      </td>

      <td>
        Limite de tentativas atingido. Gere uma nova transação para capturar.
      </td>
    </tr>

    <tr>
      <td>
        902
      </td>

      <td>
        Erro no tratamento da resposta do pagamento
      </td>

      <td>
        Erro pontual no processamento. Tente novamente.
      </td>
    </tr>
  </tbody>
</Table>

<br />

***

## Códigos de motivo `ReasonCode` e `ReasonMessage`

O `ReasonCode` e `ReasonMessage` podem indicar sucesso ou erro, e estão associados aos fluxos operacionais internos da Cielo e/ou entre a Cielo e a bandeira/emissor que ocorrem depois que a API E-commerce recebe a requisição.

O `ReasonCode` indica o código, enquanto o `ReasonMessage` traz a descrição correspondente ao código. As principais operações que retornam `ReasonCode` e `ReasonMessage` são:

* Captura;
* Cancelamento;
* Conversão de moedas;
* Criação de pagamento com boleto.

### Tabela de Reason Code e Reason Message

| Reason Code | Reason Message                              | Descrição                                                                                   |
| ----------- | ------------------------------------------- | ------------------------------------------------------------------------------------------- |
| 00          | Successful                                  | Operação concluída com sucesso.                                                             |
| 01          | AffiliationNotFound                         | Afiliação/credencial do meio de pagamento não encontrada para o estabelecimento.            |
| 02          | IssuficientFunds                            | Saldo insuficiente para realizar a operação.                                                |
| 03          | CouldNotGetCreditCard                       | Não foi possível obter os dados do cartão de crédito (ex.: token inválido ou indisponível). |
| 04          | ConnectionWithAcquirerFailed                | Falha na conexão com o adquirente.                                                          |
| 05          | InvalidTransactionType                      | Tipo de transação inválido.                                                                 |
| 06          | InvalidPaymentPlan                          | Plano de pagamento (parcelamento) inválido.                                                 |
| 07          | Denied                                      | Operação negada.                                                                            |
| 08          | Scheduled                                   | Operação agendada (ex.: recorrência).                                                       |
| 09          | Waiting                                     | Operação em espera/processamento.                                                           |
| 10          | Authenticated                               | Transação autenticada com sucesso.                                                          |
| 11          | NotAuthenticated                            | Transação não autenticada.                                                                  |
| 12          | ProblemsWithCreditCard                      | Problemas identificados com o cartão de crédito informado.                                  |
| 13          | CardCanceled                                | Cartão cancelado.                                                                           |
| 14          | BlockedCreditCard                           | Cartão de crédito bloqueado.                                                                |
| 15          | CardExpired                                 | Cartão expirado.                                                                            |
| 16          | AbortedByFraud                              | Operação abortada por suspeita/bloqueio de fraude.                                          |
| 17          | CouldNotAntifraud                           | Não foi possível executar a análise antifraude.                                             |
| 18          | TryAgain                                    | Falha temporária; recomenda-se tentar novamente.                                            |
| 19          | InvalidAmount                               | Valor da transação inválido.                                                                |
| 20          | ProblemsWithIssuer                          | Problemas com o emissor do cartão.                                                          |
| 21          | InvalidCardNumber                           | Número do cartão inválido.                                                                  |
| 22          | TimeOut                                     | Tempo limite de resposta excedido.                                                          |
| 23          | CartaoProtegidoIsNotEnabled                 | Serviço Cartão Protegido não habilitado para o estabelecimento.                             |
| 24          | PaymentMethodIsNotEnabled                   | Meio de pagamento não habilitado para o estabelecimento.                                    |
| 25          | CouldNotFindPaymentToken                    | Token de pagamento não encontrado.                                                          |
| 26          | MerchantIdJustClickNotFound                 | MerchantId do Just Click não encontrado.                                                    |
| 27          | BrandNotSupported                           | Bandeira do cartão não suportada.                                                           |
| 28          | CardOptionsNotSupported                     | Opção de cartão (ex.: recorrência, parcelamento) não suportada pelo provedor.               |
| 29          | WalletKeyIsInvalid                          | Chave da carteira digital (wallet) inválida.                                                |
| 30          | MerchantWalletConfigurationNotFound         | Configuração de carteira digital não encontrada para o estabelecimento.                     |
| 31          | BoletoRequiredDataNotSupported              | Dados obrigatórios do boleto não suportados ou enviados incorretamente.                     |
| 32          | ConnectionWithAntifraudFailed               | Falha na conexão com o serviço antifraude.                                                  |
| 33          | AbortedByCardVerification                   | Operação abortada pela verificação do cartão.                                               |
| 34          | ProblemsWithAcquirer                        | Problemas com o adquirente.                                                                 |
| 35          | ValidationError                             | Erro de validação dos dados enviados.                                                       |
| 36          | AcquirerTransactionNotFound                 | Transação não encontrada no adquirente.                                                     |
| 37          | SplitTransactionalError                     | Erro transacional no processamento do Split.                                                |
| 38          | MerchantSplitConfigurationNotFound          | Configuração de Split não encontrada para o estabelecimento.                                |
| 39          | SplitSoftDescriptorIsRequired               | Soft descriptor do Split é obrigatório e não foi informado.                                 |
| 40          | SplitFraudAnalysisIsRequired                | Análise de fraude é obrigatória para a operação de Split.                                   |
| 41          | SplitAntifraudMerchantConfigurationNotFound | Configuração antifraude do Split não encontrada para o estabelecimento.                     |
| 42          | ProviderNotFound                            | Provedor não encontrado.                                                                    |
| 43          | PaymentSettingsNotFound                     | Configurações de pagamento não encontradas.                                                 |
| 44          | SubAcquirerMerchantConfigurationNotFound    | Configuração do subadquirente não encontrada para o estabelecimento.                        |
| 45          | AbortedBySubAcquirer                        | Operação abortada pelo subadquirente.                                                       |
| 98          | InvalidRequest                              | Requisição inválida.                                                                        |
| 99          | InternalError                               | Erro interno.                                                                               |
| 100         | CieloPayCardHolderIsNotActive               | Portador do cartão não está ativo no Cielo Pay.                                             |
| 101         | CieloPayStrongValidationIsInvalid           | Validação forte (autenticação) do Cielo Pay inválida.                                       |
| 102         | CieloPayExpireDateDoesNotMatch              | Data de validade informada não corresponde à registrada no Cielo Pay.                       |
| 103         | CieloPayCardHolderApiError                  | Erro na API do portador de cartão do Cielo Pay.                                             |
| 104         | SplitPaymentFacilitatorDataNotFound         | Dados do facilitador de pagamento do Split não encontrados.                                 |

<br />

<br />

***

<br />

<br />