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) é um identificador único gerado pela bandeira Mastercard durante uma transação, utilizado para estabelecer a continuidade entre transações relacionadas.
| Fase | Descrição |
|---|---|
| Fase 1 | 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 a partir de 23/10/2026 (MIT). |
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; deve ser enviado para referenciar a transação original/anterior em operações relacionadas, como em recorrências. Consulte mais informações em Identificadores da bandeira. | string | 30 |
Payment.TransactionLinkId | 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 |