VerifyCard pelo número do cartão

AmbienteMétodoEndpoint
Sandboxhttps://apisandbox.braspag.com.br/v2/verifycard
Produçãohttps://api.braspag.com.br/v2/verifycard

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 Auth

O 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 o BrandTransactionId, que é o identificador de transações recorrentes junto às bandeiras na adquirente Rede.

Requisição

{
   "Provider":"Cielo30",
   "Card":
   {
       "CardNumber": "999999******9999",
       "Holder": "Joao da Silva",
       "ExpirationDate": "03/2026",
       "SecurityCode": "***",
       "Brand": "Visa",
       "Type": "CreditCard"
   }
}

Parâmetros do header

PropriedadeDescriçãoTipoTamanhoObrigatório
MerchantIdIdentificador da loja na Braspag.Guid36Sim
MerchantKeyChave pública para autenticação dupla na Braspag.Texto40Sim
Content-Typeapplication/jsonTexto--Sim
RequestIdxxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxTexto--Não

Parâmetros do body

PropriedadeDescriçãoTipoTamanhoObrigatório
Payment.ProviderNome da provedora do meio de pagamento.Texto15Sim
Card.CardNumberNúmero do cartão do comprador para Zero Auth e Consulta BIN. Caso seja somente requisição de Consulta BIN, enviar somente o BIN (de 6 ou 9 dígitos).Texto16Sim
Card.HolderNome do comprador impresso no cartão.Texto25Sim
Card.ExpirationDateData de validade impresso no cartão, no formato MM/AAAA.Texto7Sim
Card.SecurityCodeCódigo de segurança impresso no verso do cartão.Texto4Sim (Não, se tiver autorização do adquirente)
Card.BrandBandeira do cartão.Texto10Não
Card.TypeTipo do cartão a ser consultado ("CreditCard" / "DebitCard"). Este campo é particularmente importante devido aos cartões com funções múltiplas.Texto10Sim

Resposta

{
    "Status": 1,
    "ProviderReturnCode": "00",
    "ProviderReturnMessage": "Transacao autorizada",
    "BinData": {
        "Provider": "Master",
        "CardType": "Crédito",
        "ForeignCard": false,
        "Code": "00",
        "Message": "Analise autorizada",
        "CorporateCard": false,
        "Issuer": "Banco da Praça",
        "IssuerCode": "001",
        "CardBin": "999999",
        "CardLast4Digits": "9999",
        "Prepaid": false
    }
}
PropriedadeDescriçãoTipoTamanhoFormato
StatusStatus do Zero Auth.Número1"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
ProviderReturnCodeCódigo da consulta Zero Auth retornado pelo provedor.Número2Esse é o mesmo código retornado pelo provedor durante uma autorização padrão. Ex.: "82" - cartão inválido (para provedor Cielo30)
ProviderReturnMessageMensagem da consulta Zero Auth retornado pelo provedor.Texto512Ex.: "Transacao Autorizada"
BinData.ProviderProvedor do serviço.Texto15Ex.: "Cielo30"
BinData.CardTypeTipo do cartão retornado da Consulta BIN.Texto15Ex.: "Crédito" / "Débito" / "Múltiplo"
BinData.ForeignCardIndica se é um cartão emitido fora do Brasil.Booleano***Ex.: true/false
BinData.CodeCódigo de retorno da Consulta BIN.Número2Ex.: "00" - consulta realizada com sucesso (para provedor Cielo30)
BinData.MessageMensagem de retorno da Consulta BIN.Texto512Ex.: "Analise autorizada" - consulta realizada com sucesso (para provedor Cielo30)
BinData.CorporateCardIndica se o cartão é corporativo.Booleano***Ex.: true/false
BinData.IssuerNome do emissor do cartão.Texto512Ex.: "Banco da Praça" (sujeito a mapeamento do adquirente)
BinData.IssuerCodeCódigo do emissor do cartão.Número3Ex.: "000" (sujeito a mapeamento do adquirente)
BinData.CardBinSão os seis primeiros dígitos do cartão.Número6Ex.: "999999"
BinData.CardLast4DigitsQuatro últimos dígitos do cartão.Número4Ex.: "9999"
BinData.PrepaidIndica se o cartão é pré-pago ou nãoBooleano***Ex.: "000" (sujeito a mapeamento do adquirente)