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 e Elo;
- Getnet: Visa, Master, Elo e Amex;
- Rede: Visa, Master e Elo.
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 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) é 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 | Em breve disponibilizaremos o campo TransactionLinkId 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 a partir de 23/10/2026 (MIT). |
Saiba mais em Indicadores de bandeira.