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.
To submit a payout to a bank account, make a /storeDetailAndSubmitThirdParty request. The required fields for a payout request depend on the country/region of the recipient's bank account.
For a list of supported countries/regions for bank payouts, refer to Online payouts.
Payouts to SEPA locations
To make a payout to a bank account in the Single Euro Payments Area (SEPA), make a /storeDetailAndSubmitThirdParty request, and specify:
bank.countryCode
bank.ownerName
bank.iban
shoppername.firstname
- Required for natural persons only.shoppername.gender
- Required for natural persons only.shoppername.lastname
- For companies and natural persons.nationality
dateOfBirth
- Required for natural persons only.entityType
curl https://pal-test.adyen.com/pal/servlet/Payout/v65/storeDetailAndSubmitThirdParty \
-H 'x-api-key: ADYEN_API_KEY' \
-H 'content-type: application/json' \
-d '{
"amount":{
"currency":"EUR",
"value":500
},
"bank":{
"countryCode": "NL",
"ownerName": "S. Hopper",
"iban": "NL13TEST0123456789"
},
"shopperName":{
"firstName":"Simon",
"gender":"MALE",
"lastName":"Hopper"
},
"nationality":"NL",
"dateOfBirth":"1982-07-17",
"entityType":"NaturalPerson",
"merchantAccount":"YOUR_MERCHANT_ACCOUNT",
"recurring":{
"contract":"PAYOUT"
},
"reference":"YOUR_REFERENCE",
"shopperEmail":"s.hopper@company.com",
"shopperReference":"YOUR_UNIQUE_SHOPPER_ID"
}'
Payouts to the United States
To make a payout to a bank account in the United States, make a /storeDetailAndSubmitThirdParty request, and specify:
bank.countryCode
bank.ownerName
bank.bankAccountNumber
bank.bankLocationId
(ABA-number)bank.bankName
bank.bankCity
billingAddress.city
billingAddress.street
billingAddress.houseNumberOrName
billingAddress.stateOrProvince
billingAddress.postalCode
billingAddress.country
curl https://pal-test.adyen.com/pal/servlet/Payout/v65/storeDetailAndSubmitThirdParty \
-H 'x-api-key: ADYEN_API_KEY' \
-H 'content-type: application/json' \
-d '{
"amount":{
"currency":"USD",
"value":1200
},
"bank":{
"countryCode": "US",
"ownerName": "S. Hopper",
"bankAccountNumber": "123456789",
"bankLocationId": "011000138",
"bankName": "Wells Fargo",
"bankCity": "New York"
},
"billingAddress": {
"city": "New York",
"street": "Populierenlaan",
"houseNumberOrName": "121",
"stateOrProvince": "MA",
"postalCode": "01581",
"country": "US"
},
"shopperEmail":"s.hopper@company.com",
"merchantAccount":"YOUR_MERCHANT_ACCOUNT",
"recurring":{
"contract":"PAYOUT"
},
"reference":"YOUR_REFERENCE",
"shopperReference":"YOUR_UNIQUE_SHOPPER_ID"
}'