Are you looking for test card numbers?

Would you like to contact support?

Marketpay icon

Manual payouts

Learn how to initiate one-off payouts to cards or bank accounts.

Manual payouts give you the flexibility to trigger a payout off-schedule, and to pay out partial balances. You can manually pay out the positive balance on an account, less any negative pending balance, by making an API request or through your Customer Area.

When triggering a manual payout, you must consider the cutoff times for each bank transfer method in each region. Cutoff times affect the expected time for the account holders to receive the funds in their bank account.

Pay out manually

You can issue payouts using the Fund API or your Customer Area.

To manually trigger payouts to your account holder's bank account or to a card eligible for payouts, make a /payoutAccountHolder request.

Initiate manual payout to a bank account
Response
{
   "invalidFields": [],
   "pspReference":"9914719437810080",
   "bankAccountUUID":"000b81aa-ae7e-4492-aa7e-72b2129dce0c"
}
Response in case of a validation error
{
  "invalidFields": [
    {
      "errorCode": 29,
      "errorDescription": "Account code does not exist or invalid",
      "fieldType": {
        "field": "accountCode",
        "fieldName": "accountCode"
      }
    }
  ],
  "pspReference": "8515659454939302",
  "resultCode": "Failed"
}

Wait for the ACCOUNT_HOLDER_PAYOUT notification to confirm the status of the payout. You can also track your payouts in your Customer Area. To learn about payout status codes, see Payout notifications.

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 payouts, send the POST /payoutAccountHolder request with payoutSpeed SAME_DAY.

Set faster manual payouts
{
   "accountCode":"131863447",
   "amount":{
      "currency":"GBP",
      "value":100
   },
   "accountHolderCode":"CODE_OF_ACCOUNT_HOLDER",
   "merchantReference":"10000000",
   "description":"FasterPayoutsTest",
   "payoutSpeed":"SAME_DAY",
   "bankAccountUUID": "d23a2144-4e0a-4f64-b9b3-d8c92a83f42e"
}

Change the payout descriptor

To change the payout descriptor, send the POST /payoutAccountHolder request with the description parameter.
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