VerifyCard by card token

Validates the card with Zero Auth and returns the card information from the card token.

Environment

Method

Endpoint

Sandbox

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

Production

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

Request

{
    "Provider": "Cielo30",
    "Card": {
        "CardToken": "af1ffa95-e4a6-4ed9-9270-a9cb4c586c4a",
        "SecurityCode": "939",
        "Brand": "Visa",
        "Type": "CreditCard"
    }
}

Below is the list of request fields:

PropertyDescriptionTypeSizeRequired
MerchantIdBraspag store identifier.Guid36Yes
MerchantKeyPublic key for double authentication on Braspag.Text40Yes
Payment.ProviderName of the payment method provider.Text15Yes
Card.CardTokenToken on the Cartão Protegido that represents card data.Text16Yes
Card.SecurityCodeSecurity code printed on the back of the card.Text4Yes
Card.BrandCard brand.Text10Yes
Card.TypeType of card to be queried ("CreditCard"/"DebitCard"). This field is particularly important due to cards with multiple functions.Text10Yes

Response

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

Below is the list of response fields:

Property

Description

Type

Size

Format

Status

Zero Auth Status.

Number

1

"0" - Zero Auth query failed
"1" - Zero Auth query was successful
"99" - Query was successful, but the card status is inconclusive

ProviderReturnCode

Zero Auth query code returned by the provider.

Number

2

This is the same code returned by the provider during a standard authorization. Ex.: "82" - invalid card (for Cielo30 provider)

ProviderReturnMessage

Zero Auth query message returned by provider.

Text

512

Eg.: "Transacao Autorizada" (Authorized Transaction)

BinData.Provider

Service provider.

Text

15

Eg.: "Cielo30"

BinData.CardType

Card type returned from the BIN Query.

Text

15

Eg.: "Crédito" / "Débito" / "Múltiplo" (Credit / Debit / Multiple)

BinData.ForeignCard

Indicates whether it is a card issued outside Brazil.

Boolean


Eg.: true/false

BinData.Code

BIN Query return code.

Number

2

Ex.: "00" - successful query (for Cielo30 provider)

BinData.Message

BIN Query return message.

Text

512

Ex.: "Analise autorizada" (Analysis authorized) - query performed successfully (for Cielo30 provider)

BinData.CorporateCard

Indicates whether the card is corporate.

Boolean


Eg.: true/false

BinData.Issuer

Card issuer name.

Text

512

Eg.: "Banco da Praça" (subject to mapping by the acquirer)

BinData.IssuerCode

Card issuer code.

Number

3

Eg.: "000" (subject to acquirer mapping)

BinData.CardBin

The first six digits of the card.

Number

6

Eg.: "999999"

BinData.CardLast4Digits

Last 4 digits of the card.

Number

4

Eg.: "9999"

BinData.Prepaid

Indicates whether the card is prepaid or not

Boolean


Eg.: "000" (subject to acquirer mapping)