Valida o cartão com Zero Auth e retorna as informações do cartão a partir da consulta BIN.
| Ambiente | Método | Endpoint |
|---|---|---|
| Sandbox | post | https://apisandbox.braspag.com.br/v2/verifycard |
| Produção | post | https://api.braspag.com.br/v2/verifycard |
Saiba mais sobre essa funcionalidade na documentação.
Na requisição ao VerifyCard, você enviará o Provider junto com os dados do cartão (número ou cartão tokenizado).
Nas transações em ambiente sandbox, use o provider Simulado.
Na resposta, a verificação do ZeroAuth será exibida nas propriedades Status, ProviderReturnCode e ProviderReturnMessage. O retorno da Consulta BIN (características do cartão) estará nas propriedades do nó BinData.
Bandeiras disponíveis por adquirente no Zero Auth:
- Cielo: Visa, Master, Elo e Dinners*;
- Getnet: Visa, Master, Elo e Amex;
- Rede: Visa, Master e Elo.
*Disponível a partir de outubro de 2026.
Status do Zero AuthO resultado da validação do cartão será exibido no campo
Status; confira os valores possíveis:
“0” - Falha na consulta ao Zero Auth
“1” - Consulta Zero Auth com sucesso
“99” - Consulta com sucesso, porém o status do cartão é inconclusivo
Para mais detalhes sobre os códigos de retorno, consulte os Códigos de retorno do VerifyCard.
Para o provider Rede2, a resposta irá retornar oBrandTransactionId, que é o identificador de transações recorrentes junto às bandeiras na adquirente Rede.
Importante
- Caso a API retorne o erro 389 – Restrição Cadastral, procure o gestor comercial para validar se o serviço está habilitado corretamente; se estiver, o retorno indica que essa tentativa não pode ser validada por critérios internos da Cielo, recomendamos tentar outro cartão para concluir a validação.
Transações de verificação de cartão Visa tokenizadoA partir de 17/04/2026, será necessário enviar o criptograma em transações de verificação de cartão com tokenização na bandeira Visa:
- Envie o DPAN (token) no campo
Card.CardNumber;- Envie o criptograma no campo
Card.SecurityCode.Válido apenas para adquirente Cielo.
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 VerifyCard (apenas resposta) e para as transações de crédito, débito e recorrência.
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 VerifyCard, 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 VerifyCard não aceita o campo.
Saiba mais em Identificadores da bandeira para adquirente Cielo.