This page is for classic Adyen for Platforms integrations. If you are just starting your implementation, refer to our new integration guide instead.
With scheduled payouts, you do not have to handle the complexity around how much to pay out or when, since all available funds in the account are paid out to the account holder.
Default payout schedule
The default payout schedule for your platform is DAILY. This means that your platform is configured to automatically send payouts every day to all account holders with a positive balance. If you want to change the default payout schedule for the whole platform, contact our Support Team.
In newer classic integrations, by default, the timing for daily payouts is optimized for local timezones based on the account holder's country code.
The following schedules apply.
| Country | Optimized payout timing |
|---|---|
| Australia and New Zealand | 19:50:00 CET |
| Canada and United States | 12:50:00 CET |
| Singapore | 09:50:00 CET |
| Other countries | 05:50:00 CET |
For existing integrations, you can contact our Support Team to enable the same feature. If not enabled, daily payouts are scheduled at 00:00 CET.
Override the default payout schedule
To override your platform's default payout schedule and set a schedule for a specific account, make a POST /updateAccount call and pass a new schedule in the payoutSchedule object.
Possible schedule values are:
| Schedule | Description |
|---|---|
| DAILY | Every day at midnight (00:00:00 CET). Otherwise if using the feature for optimized timing, the schedule depends on the account holder's country code. |
| DAILY_US | Every day, optimized for US (12:50:00 CET). |
| DAILY_EU | Every day, optimized for EU/UK (05:50:00 CET). |
| DAILY_AU | Every day, optimized for AU (19:50:00 CET). |
| DAILY_SG | Every day, optimized for SG (09:50:00 CET). |
| WEEKLY | Once a week on Friday at midnight (00:00:00 CET). |
| WEEKLY_ON_TUE_FRI_MIDNIGHT | Weekly every Tuesday and Friday at midnight (00:00:00 CET). |
| BIWEEKLY_ON_1ST_AND_15TH_AT_MIDNIGHT | Monthly on the 1st and 15th at midnight (00:00:00 CET). |
| MONTHLY | First day of every month at midnight (00:00:00 CET). |
| HOLD | No scheduled payout by Adyen. In this case, you need to provide a reason for putting the payouts on hold. All payouts to this account holder have to be now triggered manually. |
You receive a response that may contain any of the following status codes:
- HTTP 200: You can use the information returned in API response but wait for the ACCOUNT_UPDATED notification to confirm when the resource has been updated in our central database.
- HTTP 202: The request has been acknowledged and added to the queue. Use the response to check and confirm the changes you made. Wait for the ACCOUNT_UPDATED notification to confirm if the payout schedule has been successfully updated.
Set the payout speed
By default, all payouts are scheduled according to the standard payout processing of the region, for example, Bankers' Automated Clearing Services (BACS) in the UK and Automated Clearing House (ACH) network in the US. To speed up this process, Adyen offers the option to set a faster payout schedule, where the payouts are available to the account holder the same day if processed before the bank cutoff time. These payouts are processed via express methods such as NPP, FPS, and Same Day ACH are restricted to the countries in which they are available.
This functionality is supported in the following countries:
- Australia
- United Kingdom
- United States
To enable faster payouts for the whole platform, contact our Support Team.
To enable the faster payout option for specific accounts, send the POST /updateAccount request with payoutSpeed SAME_DAY.
You receive a response that may contain any of the following status codes:
- HTTP 200: You can use the information returned in API response, but wait for the ACCOUNT_UPDATED notification to confirm when the resource has been updated in Adyen's central database.
- HTTP 202: The request has been acknowledged and added to the queue. Use the response to check and confirm the changes you made. Wait for the ACCOUNT_UPDATED notification to confirm whether the payout schedule has been successfully updated.
Payout descriptors
Payouts carry the default descriptor of your platform's name on the account holder's bank statement.
To change the descriptor, contact our Support Team. We can configure the descriptor to dynamically use the values of the following fields:
accountCodeaccountHolderCodeaccountDescriptionaccountHolderDescriptionpspReference, the PSP reference of the payout. You can use this reference to link a payout to the corresponding report.
The value must be between 1 to 35 characters and must only contain the following supported characters:
- Characters between a-z, A-Z, and 0-9
- Special characters: /?:().,'+ ";