Create an e-wallet transaction using an encrypted card.
| Ambiente | Método | Endpoint |
|---|---|---|
| Sandbox | post | https://apisandbox.cieloecommerce.cielo.com.br/1/sales |
| Produção | post | https://api.cieloecommerce.cielo.com.br/1/sales |
Creating a payment with an encrypted card is recommended for establishments that do not have PCI DSS certification. Request contains the Wallet node, the WalletKey field (used by Cielo to decrypt the e-wallet data), and additional tokens according to each e-wallet.
Warning
- When the Wallet node is sent in the request, the CreditCard node becomes optional;
- Due to the need for ephemeral keys to perform credit operations, recurrence is not available for e-wallet transactions.
WalletKey
WalletKey is the identifier used by Cielo to decrypt the payloads returned by an e-wallet.
Here is a list of the WalletKey formats to be passed to the Cielo E-commerce API:
| Wallet | Example |
|---|---|
| Apple Pay | 9zcCAciwoTS+qBx8jWb++64eHT2QZTWBs6qMVJ0GO+AqpcDVkxGPNpOR/D1bv5AZ62+5lKvucati0+eu7hdilwUYT3n5swkHuIzX2KO80Apx/ SkhoVM5dqgyKrak5VD2/drcGh9xqEanWkyd7wl200sYj4QUMbeLhyaY7bCdnnpKDJgpOY6J883fX3TiHoZorb/QlEEOpvYcbcFYs3ELZ7QVtjxyr O2LmPsIkz2BgNm5f+JaJUSAOectahgLZnZR+easdhghrsa/E9A6DwjMd0fDYnxjj0bQDfaZpBPeGGPFLu5YYn1IDc |
| Samsung Pay | eyJhbGciOiJSU0ExXzUiLCJraWQiOiIvam1iMU9PL2hHdFRVSWxHNFpxY2VYclVEbmFOUFV1ZUR5M2FWeHBzYXVRPS IsInR5cCI6IkpPU0UiLCJjaGFubmVsU2VjdXJpdHlDb250ZXh0IjoiUlNBX1BLSSIsImVuYyI6IkExMjhHQ00ifQ.cCsGbqgFdzVb1jhXNR --gApzoXH-fdafddfa-Bo_utsmDN_DuGm69Kk2_nh6txa7ML9PCI59LFfOMniAf7ZwoZUBDCY7Oh8kx3wsZ0kxNBwfy LBCMEYzET0qcIYxePezQpkNcaZ4oogmdNSpYY-KbZGMcWpo1DKhWphDVp0lZcLxA6Q25K78e5AtarR5whN4HUAkurQ.CFjWpHkAVoLCG8q0.NcsTuauebemJXmos_mLMTyLhEHL- p5Wv6J88WkgzyjAt_DW7laiPMYw2sqRXkOiMJLwhifRzbSp8ZgJBM25IX05dKKSS4XfFjJQQjOBHw6PYtEF5pUDMLHML3jcddCrX07abfef_DuP41PqOQYsjwesLZ8XsRj- R0TH4diOZ_GQop8_oawjRIo9eJr9Wbtho0h8kAzHYpfuhamOPT718EaGAY6SSrR7t6nBkzGNkrKAmHkC7aRwe.AbZG53wRqgF0XRG3wUK_UQ |
| Google Pay | |
EphemeralPublicKey
This is the EphemeralPublicKey format to be passed to the Cielo E-commerce API:
| Wallet | Example |
|---|---|
| Apple Pay | MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEoedz1NqI6hs9hEO6dBsnn0X0xp5/DKj3gXirjEqxNIJ8JyhGxVB3ITd0E+6uG4W6Evt+kugG8gOhCBrdUU6JwQ== |
Signature
This is the Signature format to be passed to the Cielo E-commerce API:
| Wallet | Example |
|---|---|
| Google Pay | MEUCIQCGQLOmwxe5eFMSuTcr4EcwSZu35fB0KlCWcVop6ZxxhgIgbdtNHThSlynOopfxMIxkDs0cLh2NFh5es+J5uDmaViA= |
Encrypted Card E-Wallet transaction response
The following table presents the main parameters that can be returned by the API when creating a payment with e-wallets.
| Property | Description | Type | Size |
|---|---|---|---|
ProofOfSale | Authorization number, identical to the NSU. | Text | 6 |
Tid | Transaction ID on the acquirer. | Text | 20 |
AuthorizationCode | Authorization code. | Text | 6 |
SoftDescriptor | Text to be printed on the bearer's bank statement. Note: Does not allow special characters. Available for VISA/MASTER only. | Text | 13 |
PaymentId | Order identifier field. | GUID | 36 |
ECI | Electronic Commerce Indicator. Represents how secure a transaction is. | Text | 2 |
Status | Transaction status. | Byte | 2 |
ReturnCode | Return code from the acquirer. | Text | 32 |