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:
- Automatic payouts to bank accounts.
- Manual payouts to bank accounts or eligible cards.
Automatic payouts
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.
You receive an ACCOUNT_HOLDER_PAYOUT notification after automatic payouts are initiated. Refer to Payout notifications to learn about payout status codes.
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 payoutSchedule
object.
Possible schedule
values are:
schedule | Description |
---|---|
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 reason for putting the payouts on hold. 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.
Manual payouts
Contact our Support Team to disable automatic scheduled payouts first before you can enable manual payouts.
Make a /payoutAccountHolder request to manually trigger payouts to your sub-merchant's bank account or to a card eligible for payouts.
Wait for the ACCOUNT_HOLDER_PAYOUT notification to confirm the status of the payout. Refer to Payout notifications to learn about payout status codes.
For detailed information on possible error codes, refer to General error codes.
Payout notifications
After you make a /payoutAccountHolder request, wait for the ACCOUNT_HOLDER_PAYOUT notification to confirm the status of the payout.
The ACCOUNT_HOLDER_PAYOUT may contain any of the following status.statusCode
:
statusCode |
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 estimatedArrivalDate . |
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:
pspReference , different from the initial payout. |
Check the notification and review why the payout failed.
/updateAccountHolderState
request. You can link the returned payout to the initial payout using the MarketPay payments accounting report. |
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.