Payment webhooks (deprecated)

When a payment-related event occurs in your platform, Adyen sends two kinds of webhooks:

• Standard webhooks, which informs you of events in your Adyen merchant accounts.
• Payment webhooks, which informs you of fund movements in your balance platform.

To keep track of payment-related events in your platform, make sure that your server can receive and accept webhooks.

Captures

When a payment has been captured, Adyen sends a balancePlatform.incomingTransfer.updated webhook to inform your server of expected incoming funds.

Adyen sends this webhook for every split in the payment or capture. For example, if you split the payment between 3 balance accounts, your server receives a balancePlatform.incomingTransfer.updated webhook for each balance account.

The webhook includes a data object that contains information about the event, such as:

• status: PendingIncomingTransfer
• balanceAccount: The balance account for which the webhook is sent. The balanceAccount.id corresponds to the splits.account from when you split the payment.
• originalAmount: A positive amount in the original currency of the payment.
• amount: A positive amount converted to the balance account currency, in case the original currency of the payment is different. This is the amount that will be added to the balance account.
• A platformPayment object: Contains the payment and capture details, including the original payment pspReference, the capture pspReference, and the reference values that you submitted when you made the payment or capture request. You can use these fields to match the payments to the actual fund movements.

Refunds

When you initiate a refund, Adyen sends a balancePlatform.outgoingTransfer.created webhook to inform your server that funds were deducted from balance accounts.

The webhook includes a data object that contains information about the event, such as:

• status: OutgoingTransfer
• balanceAccount: The balance account for which the webhook is sent. The balanceAccount.id corresponds to the splits.account that you sent when you split the payment or refund.
• originalAmount: A negative amount in the original currency of the refund.
• amount: A negative amount converted to the balance account currency, in case the original currency of the refund is different. This is the amount deducted from the balance account.
• A platformPayment object: Contains the payment details, including the original payment pspReference, the refunds pspReference, and the reference values that you submitted when you made the payment or refund request. You can use these fields to match the refund to the actual fund movements.

Chargebacks

When a chargeback occurs, Adyen sends a balancePlatform.outgoingTransfer.created webhook to inform your server that funds were deducted from balance accounts.

The webhook includes a data object that contains:

• status: OutgoingTransfer
• balanceAccount: The balance account for which the webhook is sent.
• originalAmount: A negative amount in the original currency of the chargeback.
• amount: A negative amount converted to the balance account currency, in case the original currency of the chargeback is different. This is the amount deducted from the balance account.
• A platformPayment object: Contains the payment details, including the original payment pspReference, the refunds pspReference, and the reference values that you submitted when you made the payment or refund request. You can use these fields to match the chargeback to the actual fund movements.

Here is an example of an outgoing transfer from a chargeback, deducting the full amount from the platform's liable balance account.

See also