post https://apisandbox.cieloecommerce.cielo.com.br/1/zeroauth/
Simula uma autorização para verificar se o cartão está válido no momento.
| Ambiente | Método | Endpoint |
|---|---|---|
| Sandbox | post | https://apisandbox.cieloecommerce.cielo.com.br/1/zeroauth/ |
| Produção | post | https://api.cieloecommerce.cielo.com.br/1/zeroauth/ |
Saiba mais sobre essa funcionalidade na documentação.
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.
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.
Resposta da validação no Zero Auth
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.
| Parâmetro | Descrição | Tipo | Tamanho |
|---|---|---|---|
Valid | Situação do cartão: True – Cartão válido False – Cartão Inválido | Boolean | *** |
ReturnCode | Código de retorno | String | 2 |
ReturnMessage | Mensagem de retorno | String | 255 |
IssuerTransactionId | 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. | String | 15 |