Events for internal transactionsv

Receive notifications about internal credits and debits that occur in your account and do not originate from traditional payments.

These events provide visibility into flows such as the Guarantor-Debtor mechanism, Split transfers, and transfers between Asaas accounts, enabling automatic reconciliation and eliminating the need to query the account statement to identify these transactions.

The events notified by Asaas are:

INTERNAL_TRANSFER_CREDIT - The account received a credit originating from an internal transaction.
INTERNAL_TRANSFER_DEBIT - The account suffered a debit due to an internal transaction. Currently, this event is triggered only in the Guarantor-Debtor flow. To track debits from an internal transfer, use the transfer events.

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

INTERNAL_LOAN: transactions related to the Guarantor-Debtor feature for operations involving subaccounts.
SPLIT: credit received from a Payment Split.
INTERNAL_TRANSFER: credit received from a direct transfer from another Asaas account.

Example JSON received [POST]

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

{
  "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 sent to regularize the Asaas account balance",
    "value": -48.52,
    "date": "2025-09-03",
    "type": "INTERNAL_LOAN"
  }
}

🚧
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