Are you looking for test card numbers?

Would you like to contact support?

Atenção, esta página não se encontra disponível em Português
Marketpay icon

Manual payouts

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

The positive balance on an account, less any negative pending balance, can be paid out to a bank account or card using our API. Manual payouts give you the flexibility to trigger a payout off-schedule, as well as to pay out partial balances.

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.

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. Refer to Payout notifications to learn about payout status codes.

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"
}

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