Balance block events

These events eliminate the need to proactively poll the financial statement to identify balance retentions, allowing for automatic reconciliation and providing immediate visibility into critical events that affect the available balance, such as Pix disputes or judicial blocks.

The events that Asaas notifies are:

• BALANCE_VALUE_BLOCKED - A value has been locked in the account balance.
• BALANCE_VALUE_UNBLOCKED - A previously locked value has been released and returned to the available balance.

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

• PIX_INFRACTION: Blocks originating from the Pix Special Return Mechanism (MED).
• JUDICIAL: Blocks originating from judicial orders.
• ADMINISTRATIVE: Blocks initiated internally by the Asaas team.

Example JSON to be received [POST]

The notification consists of a POST containing a JSON, as in this example:

{
  "id": "evt_6561b631fa5580caadd00bbe3b858607&9193",
  "event": "BALANCE_VALUE_BLOCKED",
  "dateCreated": "2024-10-16 11:11:04",
  "balance": {
    "value": 1234.56,
    "date": "2025-09-03",
    "description": "Bloqueio de saldo referente a disputa Pix.",
    "type": "PIX_INFRACTION"
  }
}