Create payment with multi-benefit card

Create a multi-benefit card payment for brands Visa, Mastercard or Elo.

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

Please refer to the documentation for further information.

ℹ️

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.


Payment with a multi-benefit card is similar to a credit card payment.

  • Send the card data in the Payment.CreditCard node
  • Set Voucher = true
  • Accepted brands are Visa, Mastercard, and Elo.
ℹ️

Capture and cancellation

  • Posterior capture is possible;
  • It is allowed to cancel the transaction within 360 days.
⚠️

Warning

Please refer to the standard voucher integration when using multibenefícios Alelo.



Body Params
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
string
required
Defaults to 8937bd5b-9796-494d-9fe5-f76b3e4da633

Store identifier in 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.

string
required
Defaults to XKGHUBSBKIRXKAVPSKWLVXYCLVJUGTNZLIHPUSYV

Public Key for Double Authentication in 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.

string

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

Responses

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