Void a credit transaction via PaymentId

put

https://apisandbox.cieloecommerce.cielo.com.br/1/sales/{PaymentId}/void

Cancel the total or partial amount of a credit transaction by providing the PaymentId.

Environment	Method	Endpoint
Sandbox	put	`https://apisandbox.cieloecommerce.cielo.com.br/1/sales/{PaymentId}/void?amount={Amount}`
Production	put	`https://api.cieloecommerce.cielo.com.br/1/sales/{PaymentId}/void?amount={Amount}`

⚠️
It is not possible to partially void a transaction that was not captured.
To partially void a transaction, the Capture field must be "true" when creating the payment with a credit card.

ℹ️
Partial cancellation
Can occur numerous times, until the full amount of the transaction is canceled.

⚠️
New mandatory field for voiding transactions due to fraud risk
As of 04/17/2026, it will be mandatory to provide the Reason field when the void reason is fraud risk identified by the merchant.
Set Reason = "HighRisk" in the request body, as shown in the example below:
{
  "Reason": "HighRisk"
}

Path Params

PaymentId

string

required

Payment ID number. Size: 36.

Query Params

Amount

int32

Order Amount (to be sent in cents). Size: 15.

Body Params

Reason

string

required

Indicates that the transaction was voided due to a fraud risk identified by the merchant. Possible value: "HighRisk". Size: 8.
Required if the transaction is voided because there is a fraud risk.
Valid for full or partial void.
Warning: This parameter will be available as of 04/17/2026.

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.

Response

It is not possible to partially void a transaction that was not captured.

Partial cancellation

New mandatory field for voiding transactions due to fraud risk

200200