After Adyen has transferred funds between your account and a counterparty, Adyen sends two types of webhooks:
- balancePlatform.transfer.updated, which informs your server that the
statusof the transfer is booked. - balancePlatform.transaction.created, which informs your server that Adyen deducted or credited the funds to your account.
This page shows examples of the Transaction webhooks that you would receive when sending or receiving funds.
Requirements
To keep track of transactions related to transfers in your platform, ensure that:
- Your server can receive and accept webhooks.
- You subscribed to the Transaction webhooks in your Balance Platform Customer Area.
The following sections explain the events that trigger transaction webhooks.
Sending funds
The following is a sample POST /transfers requesting a EUR 100.00 transfer to a third-party bank account.
After the transfer is booked , Adyen sends a balancePlatform.transaction.created webhook with the following information:
| Parameter | Description |
|---|---|
accountHolder |
An object containing information about the account holder that owns the source balance account |
amount |
An object containing the value and currency of the transaction. |
balanceAccount |
The balance account that sends the funds. |
eventId |
The unique identifier of the transaction event. |
transfer |
An object containing information about the related transfer. |
Outgoing internal transactions
The following is a sample POST /transfers requesting a EUR 100.00 transfer between two balance accounts in your platform.
After the transfer is booked , Adyen sends a balancePlatform.transaction.created webhook with the following information:
| Parameter | Description |
|---|---|
accountHolder |
An object containing information about the account holder that owns the source balance account |
amount |
An object containing the value and currency of the transaction. |
balanceAccount |
The balance account that sends the funds. |
eventId |
The unique identifier of the transaction event. |
transfer |
An object containing information about the related transfer. |
Receiving funds
After the transfer is booked , Adyen sends a balancePlatform.transaction.created webhook with the following information:
| Parameter | Description |
|---|---|
accountHolder |
An object containing information about the account holder that owns the target balance account |
amount |
An object containing the value and currency of the transaction. |
balanceAccount |
The balance account that receives the funds. |
eventId |
The unique identifier of the transaction event. |
transfer |
An object containing information about the related transfer. |