Eventos para bloqueios de saldo

Esses eventos eliminam a necessidade de consultar proativamente o extrato para identificar retenções de saldo, permitindo a conciliação automática e garantindo visibilidade imediata sobre eventos críticos que afetam o saldo disponível, como disputas Pix ou bloqueios judiciais.

Os eventos que o Asaas notifica são:

• BALANCE_VALUE_BLOCKED - Um valor foi bloqueado no saldo da conta.
• BALANCE_VALUE_UNBLOCKED - Um valor previamente bloqueado foi liberado e retornou ao saldo disponível.

O campo type no payload indica a origem do bloqueio:

• PIX_INFRACTION: Bloqueios originados pelo Mecanismo Especial de Devolução (MED) do Pix.
• JUDICIAL: Bloqueios originados por processos judiciais.
• ADMINISTRATIVE: Bloqueios realizados internamente pela equipe do Asaas.

Exemplo de JSON a ser recebido [POST]

A notificação consiste em um POST contendo um JSON, conforme este exemplo:

{
  "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"
  }
}