Events for balance blocks

These events eliminate the need to proactively query the account statement to identify balance holds, enabling automatic reconciliation and providing immediate visibility into critical events that affect the available balance, such as Pix disputes or judicial blocks.

The events notified by Asaas are:

BALANCE_VALUE_BLOCKED - A value has been blocked from the account balance.
BALANCE_VALUE_UNBLOCKED - A previously blocked value has been released and returned to the available balance.

The type field in the payload indicates the source of the block:

PIX_INFRACTION: blocks originated by the Pix Special Return Mechanism (MED).
JUDICIAL: blocks originated by judicial processes.
ADMINISTRATIVE: blocks performed internally by the Asaas team.

Example JSON received [POST]

The notification consists of a POST containing a JSON, as shown below:

{
  "id": "evt_6561b631fa5580caadd00bbe3b858607&9193",
  "event": "BALANCE_VALUE_BLOCKED",
  "dateCreated": "2024-10-16 11:11:04",
  "account": {
    "id": "47ed0d25-f9fb-4b35-b23a-d8895caf92b7",
    "ownerId": null
  },
  "balance": {
    "value": 1234.56,
    "date": "2025-09-03",
    "description": "Balance block related to a Pix dispute.",
    "type": "PIX_INFRACTION"
  }
}

🚧
Attention

As new products and features are introduced in Asaas, new attributes may be added to the Webhook. It is very important that your code is prepared not to throw exceptions if Asaas returns new attributes not handled by your application, as this may cause interruption of the synchronization queue.

We will send an email and notify our Discord whenever new fields are added to the Webhook. Notifications will be sent to the notification email configured in the Webhook settings.

Example JSON received [POST]

Attention

Related content