Payout to a bank account

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.

If you are:

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


Copy code
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


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