---
updatedAt: 2026-09-11T18:58:26.000Z
agentTools:
  siteIndex: https://docs.cielo.com.br/llms.txt
  projectIndex: https://docs.cielo.com.br/split/llms.txt
---

# Validar cartão com o Zero Auth

Simula uma autorização para verificar se o cartão está válido no momento.

O exemplo desta página é valido para envio do cartão com os dados abertos (não tokenizados).

> ℹ️ Importante
>
> * Para habilitar o Zero Auth, entre em contato com a equipe de suporte da Cielo. Se a API retornar o código de erro 323, entre em contato com o Atendimento para habilitar a funcionalidade;
> * Para ambiente sandbox, use o cartão 5502095822650000 ou 5315281703921200.
> * O Zero Auth é para clientes que usam a solução API Cielo E-commerce.

> ❗ Se a resposta for negativa, não submeta o cartão para autorização.
>
> Envie o cartão para autorização apenas se o código de resposta da verificação Zero Auth for positivo.

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

      <th>
        Método
      </th>

      <th>
        Endpoint
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        Sandbox
      </td>

      <td>
        <div className="headline-container-article-info2GaOf2jMpV0r">
          <span className="rm-APIMethod APIMethod APIMethod_fixedWidth APIMethod_post headline-container-api-method1Hc-Fm7uaccR" data-testid="http-method">post</span>
        </div>
      </td>

      <td>
        `https://apisandbox.cieloecommerce.cielo.com.br/1/zeroauth/`
      </td>
    </tr>

    <tr>
      <td>
        Produção
      </td>

      <td>
        <div className="headline-container-article-info2GaOf2jMpV0r">
          <span className="rm-APIMethod APIMethod APIMethod_fixedWidth APIMethod_post headline-container-api-method1Hc-Fm7uaccR" data-testid="http-method">post</span>
        </div>
      </td>

      <td>
        `https://api.cieloecommerce.cielo.com.br/1/zeroauth/`
      </td>
    </tr>
  </tbody>
</Table>

### Requisição

```json
{
  "CardNumber": "5502095822650000",
  "Holder": "Aline de Souza",
  "ExpirationDate": "12/2035",
  "SecurityCode": "123",
  "Brand": "Visa",
  "CardOnFile": {
    "Usage": "First",
    "Reason": "Recurring"
  }
}
```

A seguir, a listagem de campos da Requisição:

| Parâmetro           | Descrição                                                                                                                                                                                                                                                                                                                                                                                                                              | Tipo  | Tamanho | Obrigatório |
| ------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----- | ------- | :---------: |
| `CardType`          | *Creditcard ou DebitCard*                                                                                                                                                                                                                                                                                                                                                                                                              | Texto | 255     |     Sim     |
| `CardNumber`        | Número do Cartão do Comprador                                                                                                                                                                                                                                                                                                                                                                                                          | Texto | 16      |     Sim     |
| `Holder`            | Nome do Comprador impresso no cartão.                                                                                                                                                                                                                                                                                                                                                                                                  | Texto | 25      |     Sim     |
| `ExpirationDate`    | Data de e validade impresso no cartão.                                                                                                                                                                                                                                                                                                                                                                                                 | Texto | 7       |     Sim     |
| `SecurityCode`      | Código de segurança impresso no verso do cartão.                                                                                                                                                                                                                                                                                                                                                                                       | Texto | 4       |     Sim     |
| `Brand`             | Bandeira do cartão de crédito. Valores aceitos: Visa, Master, Elo e Amex.                                                                                                                                                                                                                                                                                                                                                              | Texto | 10      |     Sim     |
| `CardToken`         | **Obrigatório o envio se estiver informando cartão tokenizado**. Token do cartão na API E-commerce Cielo.                                                                                                                                                                                                                                                                                                                              | GUID  | 36      | Condicional |
| `CardOnFile.Usage`  | **First** se o cartão foi armazenado e é seu primeiro uso.<br />**Used** se o cartão foi armazenado e ele já foi utilizado anteriormente em outra transação.                                                                                                                                                                                                                                                                           | Texto | \*\*\*  |     Não     |
| `CardOnFile.Reason` | **Condicional**. Indica o propósito de armazenamento de cartões, caso o campo “Usage” for “Used”. Recurring - Compra recorrente programada (ex. assinaturas). Se for transação recorrente, usar Payment.Recurrent = true (recorrência própria) ou Recurrent.Payment = true (recorrência programada). Unscheduled - Compra recorrente sem agendamento (ex. aplicativos de serviços) Installments - Parcelamento através da recorrência. | Texto | \*\*\*  | Condicional |

### Resposta da validação no Zero Auth

```json 200 Cartão válido
{
  "Valid": true,
  "ReturnCode": "00",
  "ReturnMessage": "Transacao autorizada",
  "IssuerTransactionId": "580027442382078"
}
```
```json 200 Cartão inválido
{
  "Valid": false,
  "ReturnCode": "57",
  "ReturnMessage": "Autorizacao negada",
  }
```
```json 200 Bandeira inválida
{
  "Code": 57,
  "Message": "Bandeira inválida"
}
```
```json 200 Restrição cadastral
{
  "Code": 389,
  "Message": "Restrição Cadastral"
}
```
```json 400 Bad request
Bad request
```
```json 500 Result
Internal Server Error
```
```json 400 Serviço não habilitado
[
    {
       "ReturnCode": 322,
       "ReturnMessage": "Zero Dollar Auth is not enabled"
    }
  ]
```

A resposta sempre retorna se o cartão pode ser autorizado no momento. Essa informação apenas significa que o *cartão está válido para transacionar*, mas não indica que um determinado valor será autorizado.

Os campos retornados na resposta dependem do resultado da validação. A tabela a seguir apresenta todos os campos possíveis.

<Table>
  <thead>
    <tr>
      <th>
        Parâmetro
      </th>

      <th>
        Descrição
      </th>

      <th>
        Tipo
      </th>

      <th>
        Tamanho
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        `Valid`
      </td>

      <td>
        Situação do cartão:  

        * **True**: cartão válido  
        * **False**: cartão inválido
      </td>

      <td>
        Boolean
      </td>

      <td>
        ***
      </td>
    </tr>

    <tr>
      <td>
        `ReturnCode`
      </td>

      <td>
        Código de retorno
      </td>

      <td>
        String
      </td>

      <td>
        2
      </td>
    </tr>

    <tr>
      <td>
        `ReturnMessage`
      </td>

      <td>
        Mensagem de retorno
      </td>

      <td>
        String
      </td>

      <td>
        255
      </td>
    </tr>

    <tr>
      <td>
        `IssuerTransactionId`
      </td>

      <td>
        Identificador de autenticação do emissor para transações de crédito e débito recorrentes.\
        Este campo deve ser enviado a partir da segunda transação no modelo de recorrência própria. Já no modelo de recorrência programada, a Cielo será a responsável por enviar o campo nas transações subsequentes.
      </td>

      <td>
        String
      </td>

      <td>
        30
      </td>
    </tr>
  </tbody>
</Table>