Classic-platform icon

Payout notifications

This page is for classic Adyen for Platforms integrations. If you are just starting your implementation, refer to our new integration guide instead.

After a payout is initiated, Adyen sends an ACCOUNT_HOLDER_PAYOUT notification for each status update of the payout. The notification may contain any of the following status.statusCode:

Payout initiated

Receiving the notification with status.statusCode Initiated means that the payout has been scheduled to be sent to the account holder's bank. In this case, you can inform your account holder to expect the funds at the indicated estimatedArrivalDate.

Payout confirmed

Available in Notification v5 or later.

Receiving the notification with status.statusCode Confirmed means that the funds have left Adyen and are on their way to the account holder's bank.

You can inform your account holder to expect the funds within a few business days.

From the Confirmed notification you can gather the following details:

  • payoutReference: The unique payout id.
  • payoutAccountNumber: The account number of the bank from which the payout is initiated.
  • payoutBranchCode: The branch code of the bank from which the payout is initiated.
  • payoutAccountCountry: The country code of the bank from which the payout is initiated.
  • payoutBankName: The name of the bank the payout is made from.
    These details can help your account holder find the payout.

After receiving a Confirmed notification, it is still possible that the payout is returned to Adyen by the receiving bank.

Payout failed

Receiving the notification with status.statusCode Failed means that the payout failed due to one of the following reasons:

  • 10_132: Invalid Account Number.
  • 10_133: Invalid ACH Routing Number.
  • 10_134: No Account/Unable to Locate Account.
  • 10_135: Account Closed.
  • 10_069: Funds have been returned to Adyen.
  • Validation error. For example, payouts are not enabled for the account holder or you pay out a higher amount than the available payable balance. You receive an invalidFields array in the notification.

Make sure to update the account holder's bank account details by making a POST /updateAccountHolder request.

For detailed information on error codes and messages, refer to General error codes.

A failed payout will have a new pspReference, different from the initial payout.

If you set up scheduled payouts and the payout was returned, the account holder's payout state will be automatically disabled. Update their bank account details by making a POST /updateAccountHolder request and enable the payout state by making a POST /updateAccountHolderState request. You can link the returned payout to the initial payout using the MarketPay payments accounting report.