Validate the data of a card stored in an e-wallet.
| Environment | Method | Endpoint |
|---|---|---|
| Sandbox | post | https://apisandbox.cieloecommerce.cielo.com.br/2/zeroauth |
| Production | post | https://api.cieloecommerce.cielo.com.br/2/zeroauth |
The response always indicates whether the card can be authorized at the moment. This information only means that the card is valid for transactions, but does not indicate that a specific amount will be authorized.
The fields returned in the response depend on the validation result. The following table shows all possible fields.
If the response is negative, do not submit the card for authorization.Submit the card for authorization only if the Zero Auth verification response code is positive.
Parameters returned in the card validation response for e-wallet:
| Field | Description | Type | Size |
|---|---|---|---|
Valid | Card Status:
| Boolean | |
ReturnCode | Return code | Text | 2 |
ReturnMessage | Return message | Text | 255 |
Payment.IssuerTransactionId | Transaction identifier generated by the card brand; it must be sent to reference the original/previous transaction in related operations, such as recurring payments. See more details in IssuerTransactionId. | string | 30 |
Payment.TransactionLinkId | TransactionLinkId is a unique identifier generated by Mastercard for each transaction. It must be used to link the initial transaction to subsequent related transactions. See more details in TLID MastercardFormat: 22 alphanumeric characters (A–Z, a–z), case-sensitive, and may include hyphens (-) and underscores (_). | string | 22 |
TLID Mastercard
The Transaction Link Identifier (TLID) is a unique identifier generated by the Mastercard card brand during a transaction. It is used to ensure continuity between related transactions.
| Phase | Date | Description |
|---|---|---|
| Phase 1 | 06/30/2026 | 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 | 10/23/2026 | Required inclusion of the TransactionLinkId in the request (MIT). |
See more details in TLID Mastercard.