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.
Before you begin
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
Adyen sends webhooks for:
- Outgoing external transactions: Transactions that result from payouts to your users.
- Outgoing internal transactions: Transactions that result from sending funds from a balance account to another.
Outgoing external transactions
The following is a sample POST /transfers requesting a EUR 100.00 transfer to a transfer instrument.
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
Adyen sends webhooks for:
- Incoming external transactions: Transactions that result from topping up a balance account.
- Incoming internal transactions: Transactions that result from a balance account receiving funds from another balance account.
Incoming external transactions
After a top-up is captured , 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. |
Incoming internal transaction
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. |