Validar cartão com o Zero Auth

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

Ambiente

Método

Endpoint

Sandbox

https://apisandbox.cieloecommerce.cielo.com.br/1/zeroauth/

Produção

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;
  • Para ambiente sandbox, use o cartão 5502095822650000 ou 5315281703921200.

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

30

Language
Click Try It! to start a request and see the response here!