After an account holder starts receiving funds to their account, these funds can be paid out according to the current payout tier of the account holder. For more information on possible tiers and Know Your Customer (KYC) checks required for payouts, refer to Verification checks.
You can support the following payout methods:
You can only perform automatic payouts for bank accounts. Automatic card payouts are not supported.
By default, your marketplace account is configured to automatically send payouts daily to all eligible account holders. If you want to change the default schedule for your marketplace, contact Support Team.
Update automatic payout schedule for an account holder
In addition, you can set a new payout schedule for a particular account holder. To do this, make an /updateAccount call and pass a new
schedule in the
schedule values are:
|DAILY||Every day at midnight (00:00:00 CET).|
|MONTHLY||Monthly at midnight (00:00:00 CET).|
|WEEKLY||Weekly 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).|
|YEARLY||Every year on January 1st at midnight (00:00:00 CET).|
|HOLD||No scheduled payout by Adyen.
In this case, you need to provide a
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.
Contact our Support Team to disable automatic scheduled payouts first before you can enable manual payouts.
For detailed information on possible error codes, refer to General error codes.
The ACCOUNT_HOLDER_PAYOUT may contain any of the following
||Description||Action to take|
|Initiated||The payout has been scheduled to be sent to the sub-merchant's bank.||Inform your sub-merchant to expect the funds at the indicated
|Confirmed||The funds are on its way to the sub-merchant's bank.||Inform your sub-merchant to expect the funds within a few business days.|
|Failed||A payout can fail due to any of the following reasons:
||Check the notification and review why the payout failed.
Refund last transactions
With the /refundNotPaidOutTransfers call, you can schedule a refund for all of the transactions that have occurred since the last payout and have not been paid out yet.
Wait for the SCHEDULED_REFUNDS notification to confirm the status of the request.