Transaction webhooks

When a funds transfer takes place between one of your user's balance accounts and a counterparty bank account, balance account, or card, Adyen sends a transaction webhook to your server. This webhook informs your server that Adyen has deducted funds from or credited funds to your balance account.

Transaction webhooks can be used in combination with Transfer webhooks to stay fully up to date about the status of your transfers. While a transfer webhook is sent for every status change, transaction webhooks are only sent when the funds from the transfer are credited or debited from the balance account.

Requirements

Types of transaction webhooks

The values returned in the transaction webhook can vary depending on the following factors:

• Whether you are sending funds from (outgoing), or receiving funds to (incoming), the balance account.
• Whether the transfer is internal or external.

Sending funds (outgoing)

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

1. You send a POST /transfers requesting a EUR 100.00 transfer to a transfer instrument.

   Outgoing external transfer request

2. 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.
   id	The unique identifier of the transaction event.
   transfer	An object containing information about the related transfer.

   Outgoing external transaction webhook

Outgoing internal transactions

1. You send a POST /transfers requesting a EUR 100.00 transfer between two balance accounts in your platform.

   Outgoing internal transfer request

2. 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.
   id	The unique identifier of the transaction event.
   transfer	An object containing information about the related transfer.

   Outgoing internal transaction webhook

Receiving funds (incoming)

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 an incoming third-party transfer is booked to your user's balance account, Adyen sends a balancePlatform.transaction.created webhook with the following information:

Incoming internal transactions

After an incoming internal transfer is booked to the balance account, Adyen sends a balancePlatform.transaction.created webhook with the following information: