Skip to main content
DELETE
Cancel Charges

Cancel Charges

Request the asynchronous cancellation of one or more Payins (billet or pix) by sending a list of their IDs.
This is an asynchronous request. A 202 Accepted response means the eligible charges were queued for cancellation, not that they were already canceled. Each eligible charge is processed by a background job.

Eligibility

Cancellation Restrictions — an ID is only queued for cancellation when the charge:
  • has status = created
  • is of type pix or billet (credit-card charges are never eligible)
  • respects the minimum time since creation (see below)
IDs that are not found or not eligible are returned grouped under errors; they are not canceled.

Minimum Time Before Cancellation

  • pix: at least 5 minutes after creation
  • billet: at least 30 minutes after creation

Request Body

array
required
A list of Payin (charge) IDs to cancel.
  • Minimum: 1 item
  • Maximum: 200 items
Example: [32457, 32458, 32459]

Response

The response body is returned as-is (it does not use the standard status/data envelope).
array
The IDs that were accepted and queued for cancellation.
object
A map keyed by the reason an ID could not be queued, each pointing to the list of affected IDs (e.g. not found, wrong status, minimum time not met, not a pix/billet charge).

Request Example

Important Notes

Pix Cancellation: Pix charges are canceled instantly once the job runs.
Billet Cancellation: Billet charges require at least 1 day to move from drop_requested to canceled, as the process depends on confirmation from the payment processor.
Send between 1 and 200 IDs per request. To cancel every charge of a merchant within a date range, use Cancel Charges by Period instead.