Cancellation

ℹ️

Refer to the API Reference to access the complete request and response examples..

Void is a feature that allows the merchant to reverse a purchase order. It can be requested in cases such as out-of-stock, shopper withdrawal, or other operational needs.

In the Cielo E-commerce API, it is possible to request a void for debit and credit cards.

When it is possible to void a transaction

The availability of void depends on the transaction status:

• Authorized and not captured transactions (status 1 – Authorized)

  The void can be requested before the transaction is automatically undone.

• Captured transactions (status 2 – PaymentConfirmed)

  The void can be requested from D+1 after capture and up to 360 days after the sale authorization.

The approval of the void depends on the available balance in the merchant's financial schedule and the approval of the card issuing bank.

How void is processed

To void the same transaction more than once, it is necessary to wait 5 seconds between each request, allowing for balance update and financial schedule adjustment.

This rule applies to both full and partial voids.

To identify operations applied to the same transaction, the merchant number, authorization number, sale date, sale amount, and NSU are evaluated.

⚠️

Warning

To perform any void request, the merchant must have sufficient balance in the transaction and in the financial schedule.

Partial and full void

Partial void allows reversing only a portion of the authorized and captured amount. This type of void is only available when the transaction is created with Payment.Capture = "true".

• For credit cards, partial void can be requested more than once, until the total sale amount is voided.
• For debit cards, partial void is allowed only once.

To request a partial void, send the Amount field with the value you want to reverse.

For full void, send the Amount field with the total authorized or captured amount.

After a full void, it is not possible to request new voids for the same transaction.