Create a payment with Click to Pay

EnvironmentMethodEndpoint
Sandboxhttps://apisandbox.cieloecommerce.cielo.com.br/1/sales
Productionhttps://api.cieloecommerce.cielo.com.br/1/sales

ℹ️

Learn more about this feature in documentation.


For the Click to Pay request, send the Payment.Type parameter as “CreditCard” and the WalletType parameter as “ClickToPay”.

⚠️

CAVV and card security code

  • When a card is tokenized, Click to Pay returns the card CAVV. When sending a transaction with CAVV (Wallet.Cavv), it is not mandatory to send the card security code;
  • When a card is not tokenized, CAVV does not exist, so it is mandatory to send the card security code (Payment.CreditCard.SecurityCode).

ℹ️

Important

For Click to Pay (C2P) transactions, you do not need to send the ECI field. Cielo automatically assigns the value "2" to the field whenever it identifies this type of transaction, making the process transparent.
If a different value is sent (e.g., "5"), the system keeps the value "2", in accordance with the brand specifications.

⚠️

The Click to Pay feature works with card data or DPAN. It is not possible to create a transaction using encrypted data.

See how to decrypt card data in the Mastercard documentation.

Body Params
string

Order identification number. Warning: Allowed characters are a-z, A-Z, 0-9. Special characters and blank spaces are not allowed. Size: 50.

Customer
object
Payment
object
Wallet
object
Headers
string
required
Defaults to 8937bd5b-9796-494d-9fe5-f76b3e4da633

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.

string
required
Defaults to XKGHUBSBKIRXKAVPSKWLVXYCLVJUGTNZLIHPUSYV

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.

string

Request identifier, used when the merchant uses different servers for each GET/POST/PUT. Size: 36.

Response

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json