Eventos para movimentações internas

Estes eventos fornecem visibilidade sobre fluxos como o mecanismo de Avalista-Devedor, repasses de Split e transferências entre contas Asaas, permitindo a conciliação automática e eliminando a necessidade de consultar o extrato para identificar essas movimentações

Os eventos que o Asaas notifica são:

• INTERNAL_TRANSFER_CREDIT - A conta recebeu um crédito originado de uma movimentação interna.
• INTERNAL_TRANSFER_DEBIT - A conta sofreu um débito devido a uma movimentação interna. Atualmente, este evento é disparado apenas no fluxo de Avalista-Devedor. Para acompanhar os débitos de uma transferência interna utilize os eventos de transferências.

O campo type no payload indica a origem da movimentação:

• INTERNAL_LOAN: Movimentações relacionadas à funcionalidade de Avalista-Devedor para operações com subcontas.
• SPLIT: Crédito recebido referente a um split de pagamento.
• INTERNAL_TRANSFER: Crédito recebido de uma transferência direta de outra conta 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": "INTERNAL_TRANSFER_DEBIT",
  "dateCreated": "2024-10-16 11:11:04",
  "account": {
    "id": "47ed0d25-f9fb-4b35-b23a-d8895caf92b7",
    "ownerId": null
  },
  "internalTransferData": {
    "description": "Transferência enviada para regularização de saldo da conta Asaas",
    "value": -48.52,
    "date": "2025-09-03",
    "type": "INTERNAL_LOAN"
  }
}

🚧

• 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