Valida os dados de um cartão armazenado em e-wallet
| Ambiente | Método | Endpoint |
|---|---|---|
| Sandbox | post | https://apisandbox.cieloecommerce.cielo.com.br/2/zeroauth/ |
| Produção | post | https://api.cieloecommerce.cielo.com.br/2/zeroauth/ |
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.
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.
TLID Mastercard
O Transaction Link Identifier (TLID), enviado e retornado no campo TransactionLinkId, é um identificador único gerado pela bandeira Mastercard durante uma transação CIT, usado para vincular as transações MIT relacionadas. O TLID vale para a resposta do Zero Auth (apenas resposta) e para as transações de crédito, débito e recorrência própria.
Na Mastercard, envie IssuerTransactionId e TransactionLinkId juntos nas transações MIT: os dois parâmetros são obrigatórios.
| Fase | Descrição |
|---|---|
| Fase 1 | Vigente. O campo TransactionLinkId está disponível na resposta da validação de cartão por Zero Auth, criação de pagamento com cartão de crédito, criação de pagamento com cartão de débito e na consulta por PaymentId. |
| Fase 2 | Envio obrigatório do TransactionLinkId no request (MIT) a partir de 23/10/2026. |
Recorrência programada: nas transações seguintes, os campos
IssuerTransactionIdeTransactionLinkIdsão enviados automaticamente.
O TransactionLinkId enviado no request deve ter exatamente 22 caracteres (A-Z, a-z, 0-9, hífen e sublinhado). Se o valor estiver fora desse formato, a Cielo o ignora, sem retornar erro. Quando a Cielo envia o TLID à bandeira, a resposta traz também o SentTransactionLinkId, com o valor enviado. O request do Zero Auth não aceita o campo.
Saiba mais em Identificadores de bandeira.
Parâmetros retornados na resposta da validação de cartão em e-wallet:
| 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 |
Payment.IssuerTransactionId | Identificador da transação gerado pela bandeira, retornado na resposta do Zero Auth. O Zero Auth não recebe esse campo no request. Armazene o valor para enviá-lo, obrigatoriamente, nas transações recorrentes seguintes de crédito e débito. Na recorrência programada, o campo é enviado automaticamente nas transações seguintes. Consulte mais informações em Identificadores de bandeira. | string | 30 |
Payment.TransactionLinkId | Identificador único (TLID) gerado pela Mastercard e retornado na resposta do Zero Auth. O Zero Auth não recebe esse campo no request. Armazene o valor original para enviá-lo, junto com o Formato: 22 caracteres alfanuméricos (A-Z, a-z), com diferenciação entre maiúsculas e minúsculas e podem incluir hífens (-) e sublinhados (_). | string | 22 |