Create voucher payment

post

https://apisandbox.cieloecommerce.cielo.com.br/1/sales/

Creates transactions with the Alelo voucher payment method

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`

⚠️
Warning

Cielo only accepts the Alelo voucher.

Use the integration available on this page for Alelo multi-benefit cards.

To process an Alelo card payment via the API E-commerce Cielo, use the same request format as for a debit card transaction.

You also need to configure the following parameters:

Payment.Authenticate must be set to false or not sent;
DebitCard.Brand must be sent as "Elo".

ℹ️
Alphanumeric CNPJs will be implemented by the Brazilian Federal Revenue Service in July 2026
This change applies only to new registrations. There will be no changes to existing CNPJs.
The alphanumeric CNPJ is already supported by Cielo, with no changes required to your integration.
We recommend checking whether adjustments are needed in your merchant’s own checkout systems.

Guidelines for cancellation with Alelo voucher

Partial cancellation is not allowed;
Full cancellation can only be performed on the transaction day (D0);
To cancel after the transaction day (from D+1 onwards), you must contact Alelo.

Please refer to Void a debit transaction via PaymentId.

Body Params

MerchantOrderId

string

required

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

Headers

MerchantId

string

required

Defaults to 8937bd5b-9796-494d-9fe5-f76b3e4da633

Store identifier in API E-commerce Cielo. Size: 36. This documentation provides a default MerchantId to allow testing in the sandbox, but you can also provide the enabled MerchantId during the deployment process.

MerchantKey

string

required

Defaults to XKGHUBSBKIRXKAVPSKWLVXYCLVJUGTNZLIHPUSYV

Public Key for Double Authentication in API E-commerce Cielo. Size: 40. This documentation provides a default MerchantKey to allow testing in the sandbox, but you can also provide the enabled MerchantKey during the deployment process.

RequestId

string

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

Responses

Warning

Alphanumeric CNPJs will be implemented by the Brazilian Federal Revenue Service in July 2026

Guidelines for cancellation with Alelo voucher

201201

400400