Create an e-wallet transaction using an encrypted card.
Environment | Method | Endpoint |
|---|---|---|
Sandbox | post |
|
Production | post |
|
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/ |
Samsung Pay | eyJhbGciOiJSU0ExXzUiLCJraWQiOiIvam1iMU9PL2hHdFRVSWxHNFpxY2VYclVEbmFOUFV1ZUR5M2FWeHBzYXVRPS |
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 |