We are no longer accepting new integrations with the Payout API; use the Transfers API instead. With the Transfers API, you can:
- Handle multiple payout use cases with a single API.
- Use new payout functionalities, such as instant payouts.
- Receive webhooks with more details and defined transfer states.
- Building a new integration, refer to Pay out to bank accounts to integrate with the Transfers API.
- Already integrated with the Payout API, reach out to your Adyen contact for information on how to migrate to the Transfers API.
Payouts in stages require a four-eye policy check: each payout has to be confirmed and checked by a user different from the one that submitted the payout. When you have enabled these payouts, you will have two API credentials:
-
storePayout@Company.[Company Account Code] – This user can store payout details, and submit payouts.
-
reviewPayout@Company.[Company Account Code] – This user can confirm or decline payouts.
The examples on this page show payouts to a bank account. See payouts in stages for more examples of payouts in stages to bank accounts and wallets.
Using payouts in stages requires compliance approval and additional configuration on our end. To enable this functionality, contact your account manager or our Support Team.
Overview
Before you can make a payout, you have to save the account details.
You can choose to save the details and then submit the payout, or you can save the details and submit the details in one call. You can use the stored details when you make the next payout to the same account.
The last step is to confirm or decline the payout.
Store details and then submit a payout
- Make a /storeDetail call to save the payout details.
- Make a /submitThirdParty call to submit the payout.
- Confirm or decline the payout.
Store details and immediately submit a payout
- Make a /storeDetailAndSubmitThirdParty call to save the payout details and submit the payout.
- Confirm or decline the payout.
Store payout details
To submit a payout request, the details of the account receiving the funds need to be part of a recurring contract. The recurring contract is used for subsequent payouts to this account.
You can create a recurring contract with the /storeDetail call.
The following example shows how you can store bank account details.
You can also store the details when you submit the first payout.
Submit a payout
After you store the account details, you can submit payouts with a call to /submitThirdParty. You have to use the details of a recurring contract when you request the payout.
To use the latest created recurring contract, use the LATEST values in the request.
The following example shows how to make a payout to the bank account shown in the previous example.
Store details and submit a payout
You can store the account details and make a payout request in a single API call to /storeDetailAndSubmitThirdParty.
To do this, set the recurring value to RECURRING,PAYOUT. This creates a recurring contract, which can be used for subsequent payouts to this account.
Confirm or decline a payout
You need to confirm or decline all payouts within 7 days. After that, the payout expires.
You can also confirm and decline payouts manually in your Customer Area > Transactions > Payouts.
Confirm a payout
To confirm a payout, call the /confirmThirdParty endpoint. In the originalReference field, specify the PSP reference from the /submitThirdParty or the /storeDetailAndSubmitThirdParty response.
Your admin user assigns the permissions for confirming payment details. If they are unable to assign these permissions, they should contact Support Team.
Decline a payout
To decline a payout, call the /declineThirdParty endpoint. In the originalReference field, specify the PSP reference from the /submitThirdParty or the /storeDetailAndSubmitThirdParty response.
Your admin user assigns the permissions for declining payment details. If they are unable to assign these permissions, they should contact Support Team.
Supported countries/regions
Below is an overview of the supported countries/regions for each payout method, according to recipient country/region.
Note that:
- You can only pay out in the local currency.
- In most cases, a local entity is required.
| Recipient country/region | Bank payouts | Skrill | PayPal | Neteller |
|---|---|---|---|---|
| United States |  |
|
|
|
| Austria | |
|
|
|
| Belgium | |
|
|
|
| Republic of Cyprus | |
|
|
|
| Estonia | |
|
|
|
| Finland | |
|
|
|
| France | |
|
|
|
| Germany | |
|
|
|
| Greece | |
|
|
|
| Ireland | |
|
|
|
| Italy | |
|
|
|
| Latvia | |
|
|
|
| Liechtenstein | |
|
||
| Lithuania | |
|
|
|
| Luxembourg | |
|
|
|
| Malta | |
|
|
|
| Principality of Monaco | |
|||
| Netherlands | |
|
|
|
| Poland | |
|||
| Portugal | |
|
|
|
| Republic of San Marino | |
|||
| Slovakia | |
|
|
|
| Slovenia | |
|
|
|
| Spain | |
|
|
|
| Switzerland | |
|
||
| United Kingdom | |
|
|
|