Checkout icon

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