Verifycard pelo token do cartão

Valida o cartão com Zero Auth e retorna as informações do cartão a partir do token do cartão

ℹ️

Para clientes que usam a solução Gateway de Pagamento.

Ambiente

Método

Endpoint

Sandbox

https://apisandbox.braspag.com.br/v2/verifycard

Produção

https://api.braspag.com.br/v2/verifycard

Requisição

{
    "Provider": "Cielo30",
    "Card": {
        "CardToken": "af1ffa95-e4a6-4ed9-9270-a9cb4c586c4a",
        "SecurityCode": "939",
        "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--Não

Parâmetros do body

PropriedadeDescriçãoTipoTamanhoObrigatório
Payment.ProviderNome da provedora do meio de pagamento.Texto15Sim
Card.CardTokenToken no Cartão Protegido que representa os dados do cartão.Texto16Sim
Card.SecurityCodeCódigo de segurança impresso no verso do cartão.Texto4Sim
Card.BrandBandeira do cartão.Texto10Sim
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
    }
}

A seguir, a listagem de campos da Resposta:

Propriedade

Descrição

Tipo

Tamanho

Formato

Status

Status do Zero Auth.

Número

1

"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

ProviderReturnCode

Código da consulta Zero Auth retornado pelo provedor.

Número

2

Esse é o mesmo código retornado pelo provedor durante uma autorização padrão. Ex.: "82" - cartão inválido (para provedor Cielo30)

ProviderReturnMessage

Mensagem da consulta Zero Auth retornado pelo provedor.

Texto

512

Ex.: "Transacao Autorizada"

BinData.Provider

Provedor do serviço.

Texto

15

Ex.: "Cielo30"

BinData.CardType

Tipo do cartão retornado da Consulta BIN.

Texto

15

Ex.: "Crédito" / "Débito" / "Múltiplo"

BinData.ForeignCard

Indica se é um cartão emitido fora do Brasil.

booleano

Ex.: "true" / "false"

BinData.Code

Código de retorno da Consulta BIN.

Número

2

Ex.: "00" - consulta realizada com sucesso (para provedor Cielo30)

BinData.Message

Mensagem de retorno da Consulta BIN.

Texto

512

Ex.: "Analise autorizada" - consulta realizada com sucesso (para provedor Cielo30)

BinData.CorporateCard

Indica se o cartão é corporativo.

booleano


Ex.: "true" / "false"

BinData.Issuer

Nome do emissor do cartão.

Texto

512

Ex.: "Banco da Praça" (sujeito a mapeamento do adquirente)

BinData.IssuerCode

Código do emissor do cartão.

Número

3

Ex.: "000" (sujeito a mapeamento do adquirente)

BinData.CardBin

São os seis primeiros dígitos do cartão.

Número

6

Ex.: "999999"

BinData.CardLast4Digits

Quatro últimos dígitos do cartão.

Número

4

Ex.: "9999"

BinData.Prepaid

Indica se o cartão é pré-pago ou não

Booleano


Ex.: "000" (sujeito a mapeamento do adquirente)