This is your first endpoint! Edit this page to start documenting your API.
| Environment | Method | Endpoint |
|---|---|---|
| Sandbox | post | https://apisandbox.braspag.com.br/v2/verifycard |
| Production | post | https://api.braspag.com.br/v2/verifycard |
In the request to VerifyCard, you will send the Provider along with the card data (number or card token).
In the response, the Zero Auth verification will be displayed in the Status, ProviderReturnCode, and ProviderReturnMessage properties. The return of the BIN Query (card characteristics) will be in the properties of the BinData node.
Card brands available per acquirer in Zero Auth:
- Cielo: Visa, Master and Elo
- Getnet: Visa, Master, Elo and Amex
- Rede: Visa, Master and Elo.
Zero Auth StatusThe result of the card validation will be displayed in the Status field; check the possible values:
“0” - Zero Auth query failed
“1” - Zero Auth query successful
“99” - Query successful, but the card status is inconclusive
For the Rede2 provider, the response will return theBrandTransactionId, which is the identifier of recurring transactions with the flags at the Rede acquirer.
ImportantIf the API returns error 389 – Registration Restriction, contact the commercial manager to check if the service is correctly enabled; if it is, the response indicates that this attempt cannot be validated due to Cielo's internal criteria. We recommend trying another card to complete the validation.
Tokenized Visa Card Verification TransactionsStarting on 04/17/2026, it will be required to send the cryptogram in card verification transactions using tokenization with the Visa card brand:
- Send the DPAN (token) in the
Card.CardNumberfield;- Send the cryptogram in the
Card.SecurityCodefield.Exclusive for the Cielo acquirer.
TLID Mastercard
The Transaction Link Identifier (TLID) is a unique identifier generated by the Mastercard card brand during a transaction. It is created in the initial transaction (CIT) and must be used to associate all subsequent transactions (MIT) within the same cycle.
| Phase | Description |
|---|---|
| Phase 1 | Availability of the TransactionLinkId in the responses of VerifyCard by card number, credit card payment creation, debit card payment creation, and in the query by PaymentId. |
| Phase 2 | Required inclusion of the TransactionLinkId in the request (MIT) starting Oct 23, 2026 |
See more details in Brand identifiers for Cielo.