Are you looking for test card numbers?

Would you like to contact support?

Marketpay icon

Scheduled payouts to bank accounts

Learn how to schedule payouts to account holders.

This page is for the 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.
Update payout schedule request
 curl https://cal-test.adyen.com/cal/services/Account/v6/updateAccount \
  -H "x-API-key: YOUR_X-API-KEY" \
  -H "content-type: application/json" \
  -d '{
    "accountCode": "198360329",
    "payoutSchedule": {
        "{hint:Optional. How to handle previously scheduled payouts.}action{/hint}": "CLOSE",
        "{hint:Required when the schedule parameter is set to HOLD.}reason{/hint}": "Update the payout schedule",
        "schedule": "WEEKLY"
    }
}'
Response
{
    "invalidFields": [],
    "pspReference": "8515659450108985",
    "accountCode": "8516026831348764",
    "payoutSchedule": {
        "schedule": "WEEKLY"
    }
}

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.

Set the payout speed
{
    "accountCode": "8516026831348764",
    "payoutSpeed": "SAME_DAY",
    "payoutSchedule": {
        "schedule": "DAILY",
        "action": "UPDATE"
    }
}

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:

  • accountCode
  • accountHolderCode
  • accountDescription
  • accountHolderDescription
  • pspReference, 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: /?:().,'+ ";

See also