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