Create an e-wallet payment using a decrypted card

The authorization with a decrypted card occurs when the store itself decrypts the payload received from the wallet and sends it directly to the Cielo E-commerce API for processing and authorization. In this scenario, send the following request model for authorization:

ℹ️
For MIT, there is no need to send the cryptogram, because the token was already validated in the original CIT transaction. In other words:

in CIT transactions, the CAVV must be sent in the Payment.Wallet.Cavv field;

in MIT transactions, the CAVV must not be sent.

See more about CIT and MIT transactions at Transaction Initiator Indicator.

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`

Request

-- Envio de cartão
{
  "MerchantOrderId": "Loja123456",
  "Customer": {
    "Name": "Aline de Souza",
    "Identity": "58154781050",
    "IdentityType": "CPF"
  },
  "Payment": {
    "Type": "CreditCard",
    "Amount": 1100,
    "Provider": "Cielo",
    "Installments": 1,
    "CreditCard": {
      "CardNumber":"4091688625337641",
      "Holder":"Aline de Souza",
          "ExpirationDate":"12/2035",
          "SecurityCode":"333",
          "Brand":"Visa"
    },
    "Wallet": {
      "Type": "Tipo de wallet",
      "Eci":"7",
      "Cavv":"AM1mbqehL24XAAa0J04CAoABFA=="
    }
  }
}

Property	Type	Size	Required	Description
`MerchantId`	Guid	36	Yes	Store identifier atCielo.
`MerchantKey`	Text	40	Yes	Public key for dual authentication at Cielo.
`RequestId`	Guid	36	No	Request identifier, used when the merchant uses different servers for each GET/POST/PUT.
`MerchantOrderId`	Text	50	Yes	Order ID number.
`Customer.Name`	Text	255	No	Customer's name. Warning: Only a-z, A-Z characters are allowed. Special characters and numbers are not allowed.
`Customer.Status`	Text	255	No	Customer's registration status ("NEW" / "EXISTING").
`Payment.Type`	Text	100	Yes	Payment method type.
`Payment.Amount`	Number	15	Yes	Order amount in cents.
`Payment.Installments`	Number	2	Yes	Number of installments.
`CreditCard.CardNumber.`	Text	19	Yes	Customer's card number
`CreditCard.Holder`	Tex	25	No	Cardholder name printed on the card (cardholder). Does not accept special characters or accents. Important: the cardholder's name is provided by the wallet. If the merchant has received the cardholder's name, we recommend including it in the request to Cielo. If the merchant does not have the cardholder's name, do not send the `CreditCard.Holder` field or send it with a null value.
`CreditCard.SecurityCode`	Text	4	No	Security code printed on the back of the card.
`CreditCard.Brand`	Text	10	Yes	Card brand (Visa / Master / Amex / Elo / Aura / JCB / Diners / Discover).
`Wallet.Type`	Text	255	Yes	Wallet type: `AndroidPay` / `ApplePay` / `SamsungPay`
`Wallet.Walletkey`	Text	255	No, when using a decrypted card	Cryptographic key representing card data. Consult the table WalletKey for more information.
`Wallet.Eci`	Text	3	Yes (when the wallet returns)	The ECI (Electronic Commerce Indicator) represents how safe a transaction is. This value must be taken into account by the merchant when deciding on capturing the transaction.
`Wallet.Cavv`	Text	255	Yes	Validation field returned by Wallet and used as authorization basis.

Response

{
  "MerchantOrderId": "Loja123456",
  "Customer": {
    "Name": "Aline de Souza"
  },
  "Payment": {
    "ServiceTaxAmount": 0,
    "Installments": 1,
    "Interest": 0,
    "Capture": false,
    "Authenticate": false,
    "Recurrent": false,
    "CreditCard": {
      "CardNumber": "4091688625337641",
      "Holder": "Aline de Souza",
      "ExpirationDate": "12/2035",
      "SaveCard": false,
      "Brand": "Visa"
    },
    "Tid": "0319040817883",
    "ProofOfSale": "817883",
    "AuthorizationCode": "027795",
    "Wallet": {
      "Type": "TIPO DE WALLET",
      "Eci": 0
    },
    "SoftDescriptor": "123456789ABCD",
    "Amount": 100,
    "ReceivedDate": "2018-03-19 16:08:16",
    "Status": 1,
    "IsSplitted": false,
    "ReturnMessage": "Operation Successful",
    "ReturnCode": "4",
    "PaymentId": "e57b09eb-475b-44b6-ac71-01b9b82f2491",
    "Type": "CreditCard",
    "Currency": "BRL",
    "Country": "BRA",
    "Links": [
      {
        "Method": "GET",
        "Rel": "self",
        "Href": "https://apiquerysandbox.cieloecommerce.cielo.com.br/1/sales/e57b09eb-475b-44b6-ac71-01b9b82f2491"
      },
      {
        "Method": "PUT",
        "Rel": "capture",
        "Href": "https://apisandbox.cieloecommerce.cielo.com.br/1/sales/e57b09eb-475b-44b6-ac71-01b9b82f2491/capture"
      },
      {
        "Method": "PUT",
        "Rel": "void",
        "Href": "https://apisandbox.cieloecommerce.cielo.com.br/1/sales/e57b09eb-475b-44b6-ac71-01b9b82f2491/void"
      }
    ]
  }
}

Property	Description	Type	Size	Format
`ProofOfSale`	Authorization number, identical to NSU.	Text	6	Alphanumeric
`Tid`	Transaction ID in the acquirer.	Text	20	Alphanumeric
`AuthorizationCode`	Authorization code.	Text	6	Alphanumeric
`SoftDescriptor`	Text to be printed on customer's invoice. Note: Does not allow special characters. Available for VISA/MASTER only.	Text	13	Alphanumeric
`PaymentId`	Order identifier field.	Guid	36	xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
`ECI`	Eletronic Commerce Indicator. Represents how secure a transaction is.	Text	2	E.g.: 7
`Status`	Transaction status.	Byte	***	2
`ReturnCode`	Return code from acquirer.	Text	32	Alphanumeric
`ReturnMessage`	Return message from acquirer.	Text	512	Alphanumeric
`Type`	Wallet type: `ApplePay`, `GooglePay` or `SamsungPay`	Text	255	Alphanumeric
`Walletkey`	Cryptographic key representing card data. Consult the table WalletKey for more information.	Text	255	Check the WalletKey table

WalletKey Table

WalletKey is the identifier used by Cielo to decrypt payloads returned by the wallet.

The formats of WalletKey that should be passed to the Cielo E-commerce API are:

Wallets	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	{"encryptedMessage":"0mXBb94Cy9JZhMuwtrBhMjXb8pDslrNsN5KhcEqnowOINqJgjXHD36KcCuzpQQ4cDAe64ZLmk2N3UBGXsN9hMMyeMakXlidVmteE +QMaNZIor048oJqlUIFPD54B/ic8zCdqq3xnefUmyKQe0I03x57TcEA9xAT/E4x3rYfyqLFUAEtu2lT0GwTdwgrsT8pKoTldHIgP+wVNTjrKvJrB4xM/Bhn6JfcSmOzFyI6w37 mBU71/TK761nYOSxt7z1bNWSLZ4b8xBu1dlRgen2BSlqdafuQjV3UZjr6ubSvaJ8NiCh5FD/X013kAwLuLALMS2uAFS9j8cZ6R6zNIi13fK6Fe4ACbFTHw LzSNZjQiaRDb6MlMnY8/amncPIOXzpirb5ScIz8EZUL05xd+3YWVTVfpqgFo1eaaS+wZdUyRG0QEgOsr6eLBoH8d5lfV9Rx6XdioorUuT7s1Yqc0OJZO +fhBt6X0izE9hBGTexdZyg\u003d\u003d","ephemeralPublicKey":"BMdwrkJeEgCOtLevYsN3MbdP8xbOItXiTejoB6vXy0Kn0ZM10jy4Aasd6jTSxtoxo TpFydLhj5kzoOhbw2OzZu0\u003d","tag":"yAQIjWZ0VuCC7SWyYwc4eXOzpSUKhZduF9ip0Ji+Gj8\u003d"}