VerifyCard pelo número do cartão

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

Ambiente	Método	Endpoint
Sandbox	post	`https://apisandbox.braspag.com.br/v2/verifycard`
Produção	post	`https://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.

⚠️
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

Requisição

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

Parâmetros do header

Propriedade	Descrição	Tipo	Tamanho	Obrigatório
`MerchantId`	Identificador da loja na Braspag.	Guid	36	Sim
`MerchantKey`	Chave pública para autenticação dupla na Braspag.	Texto	40	Sim
`Content-Type`	application/json	Texto	--	Sim
`RequestId`	xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx	Texto	--	Não

Parâmetros do body

Propriedade	Descrição	Tipo	Tamanho	Obrigatório
`Payment.Provider`	Nome da provedora do meio de pagamento.	Texto	15	Sim
`Card.CardNumber`	Nú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).	Texto	16	Sim
`Card.Holder`	Nome do comprador impresso no cartão.	Texto	25	Sim
`Card.ExpirationDate`	Data de validade impresso no cartão, no formato MM/AAAA.	Texto	7	Sim
`Card.SecurityCode`	Código de segurança impresso no verso do cartão.	Texto	4	Sim (Não, se tiver autorização do adquirente)
`Card.Brand`	Bandeira do cartão.	Texto	10	Não
`Card.Type`	Tipo do cartão a ser consultado ("CreditCard" / "DebitCard"). Este campo é particularmente importante devido aos cartões com funções múltiplas.	Texto	10	Sim

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
    }
}

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)