Payouts must be submitted using the Third-party payout API or Batch files. Additional payee data also needs to be submitted with a payout request. In addition, you can no longer send payout requests using
If you have been submitting payouts using another method, you need to update your integration.
Contact Support Team prior to testing any changes to your integration. They will ensure that your user credentials and permissions are updated.
Who is impacted by this change?
If you are using the
/submit endpoints, you need to migrate to the
/submitThirdParty endpoints, respectively. If you are already using third-party calls, but your version is lower than v25, update your integration to the new version to submit additional payee information.
/refundWithData will remain active for submitting unreferenced refunds.
If you are unsure whether you are affected or not, contact Support Team with your Merchant account name and webservice user you use to send payout requests.
Additional data required for payouts
In order to improve the mandatory sanctions screening for payouts, we require you to submit additional payee information (full name, date of birth, nationality, and entity type) with a payout request, depending on the region where you are performing the payout. Amend your payout calls/request files accordingly in order to forward the details.
Switch to the latest version of Payout API / Batch files
You must also update your integration to the version v25 of the Payout API. You can find the specification of the payout calls and batch file submission at Third-party payouts API.
To add additional payee information to an existing recurring contract, send a
/submitThirdParty request containing the relevant fields. For more information on these fields, see API Explorer.
As we have deprecated the use of
/refundWithData calls to submit payout requests, you need to switch your integration to our third-party Payout API or Batch file type.
Payouts submitted through this integration will have payout-specific journal statuses (
PaidOut) in Adyen's reporting, including the Monthly finance and Settlement details reports. We recommend that you review your reconciliation processes, particularly if you are automatically consuming any reporting, to ensure you are able to handle a
PaidOut line item instead of the
Refunded journal status currently provided from payouts submitted through
Main changes and documentation
Additional payout recipient data will need to be submitted:
shopperName, i.e. the personal or registered company name of the payee.
dateOfBirth, date of birth or establishment.
nationality, the nationality of the payee.
entityType, indicator if the payee is a person or company.
Use of third-party Payout API, rather than submitting a
Review the API documentation carefully, as other changes may have been implemented between the version current at the point of your initial integration and the version v25. Further information can be found under: