Search

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.

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.

The default payout schedule for your platform account is DAILY. This means that your platform is configured to automatically send payouts daily to all account holders with a positive balance. If you use (or when using) daily payouts, we recommend the region-specific schedules to ensure optimized payout timing. If you want to change the default schedule for the whole platform, contact Support Team.

Set the payout schedule

To update a specific account's payout schedule, 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).
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

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