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;
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
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) |