post
https://apisandbox.cieloecommerce.cielo.com.br/1/zeroauth/
Simulate an authorization to check if the card is currently valid.
| Environment | Method | Endpoint |
|---|---|---|
| Sandbox | post | https://apisandbox.cieloecommerce.cielo.com.br/1/zeroauth/ |
| Production | post | https://api.cieloecommerce.cielo.com.br/1/zeroauth/ |
The example on this page is valid for sending the card with open data (not tokenized).
Important
- To enable Zero Auth, contact the Cielo support team. If the API returns error code 323, contact Support to enable the functionality;
- If 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;
- To simulate authorization scenarios, check the Zero Auth documentation in sandbox.
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.
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.
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 | Description |
|---|---|
| Phase 1 | TransactionLinkId returns in the responses of card validation by Zero Auth, 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 October 10 2026. |
See more details in Card Brand Identifiers.