ℹ️

Please refer to the API Reference for the full request and response examples.

E-wallets are electronic safes (repositories) of cards and payment data for the physical and e-commerce customers. Digital wallets allow a customer to register their payment details, making the purchase process more convenient and secure.

ℹ️

To use wallets in the API E-commerce Cielo, the merchant must have the wallets integrated in their checkout.

Contact the provider of your choice for further information on how to contract the service.

Available E-wallets

API E-commerce Cielo supports the following digital wallets:

• GooglePay
• ApplePay
• SamsungPay

⚠️

Warning

• When the Wallet node is sent in the request, the CreditCard node becomes optional.
• When the Wallet node is sent in the request, for the debit card it is required to send the DebitCard node containing the "ReturnUrl".

Card brands supported by the wallets

Vist the wallet website to know more about supported card brands:

• GooglePay
• ApplePay
• SamsungPay
  
  

E-wallet Integration

There are two options for sending an authorization request using the payment method e-wallet:

1. Authorization using encrypted card: the request contains the node Wallet, the parameter WalletKey (used by Cielo to decrypt e-wallet data) and additional tokens provided by each e-wallet. This type of integration is recommended for merchants who are not PCI DSS compliant;
2. Authorization using decrypted card: the request contains the node Wallet and the merchant themselves decrypt e-wallet data and send the open data to authorization. This type of integration is recommended for merchants who are PCI DSS compliant.

Zero Auth

Zero Auth allows the merchant to check whether a card is valid for making a purchase before the order is completed. Zero Auth simulates an authorization without affecting the credit limit or alerting the cardholder about the test. Please refer to [Zero Auth] for further information.