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",
  "account": {
    "id": "47ed0d25-f9fb-4b35-b23a-d8895caf92b7",
    "ownerId": null
  },
  "balance": {
    "value": 1234.56,
    "date": "2025-09-03",
    "description": "Bloqueio de saldo referente a disputa Pix.",
    "type": "PIX_INFRACTION"
  }
}

🚧

• Com a entrada de novos produtos e funções dentro do Asaas, é possível que novos atributos sejam incluídos no Webhook. É muito importante que seu código esteja preparado para não gerar exceções caso o Asaas devolva novos atributos não tratados pela sua aplicação, pois isso poderá causar interrupção na fila de sincronização.
• Enviaremos um e-mail e avisaremos em nosso Discord quando novos campos forem incluídos no Webhook. O disparo será feito para o e-mail de notificação definido nas configurações do webhook