Validate card with Zero Auth

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;

For sandbox environment, use the card 5502095822650000.

❗
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.

Body Params

CardType

string

required

Defines the type of card used:

CreditCard
DebitCard

If not sent, CreditCard is the default. Size: 255.

CardNumber

string

required

Card Number. Size: 16.

Holder

string

required

Cardholder's name, printed on the card. Size: 25.

ExpirationDate

string

required

Expiration date. Size: 7.

SecurityCode

string

required

Card Security code. Size: 4.

SaveCard

boolean

required

Defines if the card must be tokenized.

Brand

string

required

Card brand:
Visa
Master
ELO. Size: 10.

CardToken

string

Conditional obligation Card Token in API E-commerce Cielo. Size: 36.

CardOnFile

object

Headers

MerchantId

string

required

Store identifier in Cielo. Size: 36. This documentation provides a default MerchantKey to allow testing in the sandbox, but you can also provide the enabled MerchantKey during the deployment process.

MerchantKey

string

required

Public Key for Double Authentication in Cielo. Size: 40 This documentation provides a default MerchantId to allow testing in the sandbox, but you can also provide the enabled MerchantId during the deployment process.

Content-type

string

Defaults to Application/json

Responses

Language


xxxxxxxxxx
1
curl --request POST \
2
     --url https://apisandbox.cieloecommerce.cielo.com.br/1/zeroauth/ \
3
     --header 'Content-type: Application/json' \
4
     --header 'accept: application/json' \
5
     --data '{"SaveCard":true}'

Click Try It! to start a request and see the response here! Or choose an example:

application/json

Validate card with Zero Auth

ℹ️
Important

❗
If the response is negative, do not submit the card for authorization.

ℹ️Important

❗If the response is negative, do not submit the card for authorization.

200200

400400

500500

ℹ️
Important

❗
If the response is negative, do not submit the card for authorization.