Release notes

Learn about the latest updates for Adyen for Platforms.

You can find all changes related to Adyen for Platforms on this page. To make it easier to have an overview of the changes in a specific area of your integration, we organized the release notes into the following categories:

  • APIs: new versions and changes to existing versions.
  • Notifications: new versions and changes to existing versions.
  • Hosted onboarding: changes to the hosted onboarding page and related pages in Customer Area, and changes to existing versions of the /getOnboardingUrl endpoint.
  • Customer Area: changes to pages under the Platform section in Customer Area, except pages related to hosted onboarding.
  • KYC: changes to how Adyen handles KYC verification.
  • Reports: changes to how reports are generated.
  • General: other changes that do not fall in any of the previous categories, such as new supported countries or improvements to payouts.
Get updates by RSS
Filter by
Category...
Version...
January 2025
SunMonTueWedThuFriSat
1234
567891011
12131415161718
19202122232425
262728293031
Select dates
Copy url
icon
Hosted onboarding
Improved

Account holders with businesses based in Cyprus can now enter up to 8 characters of their company number on the Hosted Onboarding Page.


Copy url
icon
Hosted onboarding
Fixed

We fixed the issue where a signatory's email address and phone number did not always appear under their personal details. It is no longer required to enter these details more than once.


Copy url
icon
Hosted onboarding
Improved

The hosted onboarding page now shows a warning banner when any of the roles required for the KYC process are missing. The banner specifies the missing role(s).


Copy url
icon
Hosted onboarding
Improved

When adding or updating shareholder information on the hosted onboarding page, the triggered ACCOUNT_HOLDER_UPDATED notification now includes the shareholderType field for each shareholder. If a shareholder has multiple roles, for example, Owner and Controller, the shareholderCode will be the same for the different shareholderType.


Copy url
icon
Hosted onboarding
Fixed

We fixed the issue where deleting shareholders on HOP did not completely remove the resource from your account holders' profile.


Copy url
icon
Hosted onboarding
Improved

When adding a Swedish bank account, account holders can now also enter 5-digit branch codes (clearing numbers).


Copy url
icon
General
Removed

Because EUR is now the only official currency in Croatia, Adyen no longer supports bank accounts in HRK.


Copy url
icon
Hosted onboarding
Changed

Account holders residing in the US now need to provide their entire SSN or TIN (9 digits) on the hosted onboarding page.


Copy url
icon
API
Improved

You can now use the /deleteShareholders endpoint to delete shareholders with multiple shareholder types.


Copy url
icon
Hosted onboarding
New
  • Your account holder's bank information using Tink as a third-party service.
  • When your account holder uploads a supporting document on HOP, its status now changes to Processing instead of Finished until it is verified.

Copy url
icon
KYC
Fixed

When adding a Swedish bank account, your account holders are now required to enter the account number instead of the IBAN to avoid possible issues with payouts.


Copy url
icon
Hosted onboarding
Improved

Your account holders can now assign multiple shareholder types to the same individual on the Hosted Onboarding Page.


Copy url
icon
Hosted onboarding
Changed

It is now possible to enter a 5-digit branch code for Swedish bank accounts on the Bank details page on HOP.


Copy url
icon
API
Changed

We increased the maximum character length in the description field of the POST /payoutAccountHolder request to 200 characters.


Copy url
icon
Hosted onboarding
Fixed

Your account holders can now update the BIC/SWIFT code on HOP.


Copy url
icon
Hosted onboarding
Improved

The BIC/SWIFT code field is only required for Canadian bank accounts if the configured currency is not CAD (C$).


Copy url
icon
Customer Area
Improved

The PSP reference is now also shown for refunds in the Transfer detail section.


Copy url
icon
Hosted onboarding
Fixed

We fixed the issue with validating the company phone number after it was edited on HOP.


Copy url
icon
Reports
Fixed

We fixed the issue with generating the Settlement details report in the test environment of your Customer Area.


Copy url
icon
Hosted onboarding
Fixed

Account holders can now enter 10-digit bank account numbers in New Zealand.


Copy url
icon
Hosted onboarding
Fixed

To enable payouts, HOP now request information on the correct business owner type. Previously, it requested information on a controller instead of a signatory.

New

When prodiving their bank account details, your account holders can now choose between the following options:

  • Instant verification by a third-party service
  • Verification by Adyen, where they need to manually enter their bank details and upload supporting documents

Copy url
icon
General
New

The upgraded Adyen for Platforms infrastructure's documentation is now available for new integrations. If you have already integrated with our system, refer to the classic integration guide.


Copy url
icon
Hosted onboarding
Improved

In the Business owners section, account holders will now see the specific role (Owner, Signatory, or Controller) of the individuals whose information is required for verification.

New

Account holders can now delete legal arrangements directly on HOP.


Copy url
icon
KYC
Fixed

Account holders are no longer required to provide a tax ID number for their business in the Czech Republic and Slovakia.


Copy url
icon
Customer Area
New

You can now suspend account holders on the Overview tab, next to Account Holder Operations.


Copy url
icon
API
Fixed
  • When adding signatories, sending an empty string in the signatoryCode now works as expected. The API no longer returns an error and the signatory is created.

Copy url
icon
Hosted onboarding
Fixed
  • When adding a publicly listed parent company, the dropdown for selecting a Stock exchange is now working again.
  • When an ultimate beneficial owner was created without a role (owner, controller, or signatory), the ID document button is no longer shown. The account holder must provide data first before they can upload a document.
  • Account holders can now add signatories who have addresses in China.
  • Fixed the incorrect error message shown for invalid Singapore ID numbers.

Copy url
icon
Hosted onboarding
Fixed

We added the missing input fields for entering a legal arrangement member's personal details on HOP.


Copy url
icon
Customer Area
Fixed

The link to the target account in case of split payments now works as expected. Previously, the link in Transactions > Payments > Payment details > Payments > Target account pointed to the first account of the associated account holder.


Copy url
icon
Hosted onboarding
Fixed
  • We fixed the issue where a 12 hour or more timezone difference between the account holder's system and an individual's place of birth altered their date of birth.
  • When onboarding a public company, not all required information was requested in the Company details section. Your account holders must now provide data in one of the following fields:
    • Stock exchange
    • Stock ticker
New

If your platform is already configured to implement the new verification requirements, we now require your account holders to provide the type of the shareholders associated with their business.


Copy url
icon
General
Improved

If you have set a payout descriptor but its value is empty, the payout description now falls back to the default value (your platform's name).


Copy url
icon
Customer Area
Fixed
  • The Merchant reference that you provide when paying out manually from the Customer Area is now shown in the Transactions list when you look up the payout.
  • When your account holder updates their bank account, the new account is now also shown in the KYC > Summary section and the Payouts tab. Previously, the change was only reflected in the KYC > Timeline section.

Copy url
icon
Hosted onboarding
Fixed
  • Account holders that have bank accounts outside of the country they are operating in can now also select local currencies. For example, an account holder in DK that adds an NO bank can now choose between EUR and NOK currencies.
  • When entering a Swedish account number, the bank details form now only shows Branch code. Previously, it also showed that account holders can add the BIC/SWIFT which is different from the branch or clearing code.
  • Fixed broken icons.

Copy url
icon
Customer Area
New

For sub-merchants that have legal arrangements and parent companies, you can now view the following in the Company and Legal Arrangement verification checks on the KYC tab:

  • legalArrangementCode
  • legalArrangementEntityCode
  • ultimateParentCompanyCode

Copy url
icon
Hosted onboarding
New

You can now require account holders to upload their IDs and bank statements upfront instead of only requiring documents when the automatic verification fails. To enable this feature for your platform, contact our Support Team.


Copy url
icon
Customer Area
Fixed

The PSP references of transactions that are not related to payments, such as transfers, are no longer incorrectly linked to the Payment details page.


Copy url
icon
Hosted onboarding
Improved

Account holders can now provide a company registration number consisting of a maximum of 10 digits.


Copy url
icon
Customer Area
Improved

Timezones are now included whenever dates are shown in your Customer Area. For example, when you select the KYC tab for a sub-merchant, you will now see the date and timezone of when Adyen performed the checks.


Copy url
icon
API
Improved

When providing an accountHolderDetails.webAddress, you must now provide a URL with the following format: a protocol (http:// or https://), a domain, and a maximum 1024 characters. Otherwise, the request fails.


Copy url
icon
Hosted onboarding
Fixed
  • HOP now collects the shareholder's ID number even when the account holder's and shareholder's countries are different.

  • When changing the legal entity type from individual to business, account holders are now prompted to provide the address or Employer Identification Number (EIN) of the organization. Previously, when an individual legal entity was created without an address then later changed to an organization, the verification check required for payouts failed due to the lack of address.


Copy url
icon
API
Improved

When making a POST /uploadDocument request with a documentType set to SUPPORTING_DOCUMENTS, you can now send multiple documents without overwriting your previous uploads. You can use this type for documents related to shareholders and organizational charts. All other document types, such as passports and bank statements, still follow the default behavior: previous uploads are overwritten if you send an API request with the same type.


Copy url
icon
Hosted onboarding
Fixed

Account holders with a NOK bank account can now provide the BIC/SWIFT code on the Bank details page. The code is required for payouts.

Improved

For Australian businesses, we improved the UI for collecting the Australian Company Number (ACN) and Australian Business Number (ABN) to make it clear which number the account holder needs to provide.


Copy url
icon
Customer Area
Fixed

When you view the details of a split payment and select the Target Account, the sub-merchant transaction page that you're redirected to now shows the account holder code.


Copy url
icon
General
New

By default, daily payout schedules are now optimized for local timezones based on the account holder's country code. For example, funds for an account holder in Australia gets paid out at 19:50:00 CET. The account holder's local timezone schedule overrides the default schedule of your platform.

This feature is enabled for new integrations. If you want this feature for your existing integration, contact our Support Team.


Copy url
icon
API
Improved

When making an instant card payout with a POST /payoutAccountHolder request, the value that you send in the description field now appears on the sub-merchant's bank statement.


Copy url
icon
Hosted onboarding
Changed

Your account holders must provide their full address before adding their bank details.

New

Your account holders can now delete bank accounts even if there is only one bank account saved.


Copy url
icon
Reports
New

Payment Merchant Reference, Capture Psp Reference, and Capture Merchant Reference are now also retrieved for chargebacks in the Marketplace Payments accounting report.


Copy url
icon
Reports
Fixed

When manually generating a Marketplace Hourly Payment Accounting Report, you now get a report that matches the time range in UTC.


Copy url
icon
API
Fixed

Copy url
icon
General
Improved

For platforms that are liable for chargebacks, the full amount of chargebacks or chargeback reversals can now be booked entirely from your liable account regardless of the split. To enable this functionality, contact our Support Team.


Copy url
icon
Customer Area
Fixed

When using the filters in the Transactions page, payouts to cards are now shown in the list.


Copy url
icon
Hosted onboarding
Fixed
  • HOP now first checks if the shareholder type was already provided before showing the message to upload a document.
  • When using instant bank verification, the Start button is now shown only at the beginning of the process.
  • The feature for limiting account holders to provide only one bank account is again working as expected. To enable this for your platform, contact our Support Team.

Copy url
icon
Hosted onboarding
Fixed

It is now possible for Finnish account holders to enter Swedish bank account details on HOP.

New

When providing details for instant bank account verification, your account holders can now select banks from Denmark.


Copy url
icon
Hosted onboarding
Fixed
  • Account holders can now update the bank name in the page for manual bank verification.
  • Account holders that are required to fill out the PCI DSS questionnaire can now do so even if they do not have a web address.

Copy url
icon
Reports
Improved

If you pay out to bank accounts in California, your Marketplace Payments accounting reports will now have a smaller file size. This is because Adyen no longer needs to include the "Right To Refund" text so we removed the text under the Refund terms column.


Copy url
icon
Hosted onboarding
Fixed
  • HOP now displays a descriptive error message advising further action when your account holder attempts to change a legal entity type while stores are in active or pending status
  • We added a new Singapore ID number field that must be filled for Singaporean citizens or residents to enable upfront verification. Previously, the ID number was still required, but there was no field for it, which resulted in errors during validation.

Copy url
icon
General
Fixed

We fixed the issue where shareholders could be created with the same name and shareholder type. It is no longer possible to create duplicate shareholders.


Copy url
icon
API
Fixed

When uploading a document for a business account holder that has a shareholderReference field, the field is now always returned in the POST /uploadDocument response. Previously the field was sometimes not returned.


Copy url
icon
Hosted onboarding
New

New supported language: Slovakian.

Fixed
  • Account holders can now update a phone number after it is verified. Previously, the leading + was omitted when saving and this caused validation errors.
  • If an ID number is required in the country of the shareholder but not in the country of the business, HOP was unable to collect the required information. We fixed this so that now HOP shows the section to upload a document for the shareholder.
Improved
  • Account holders can now upload legal arrangement documents up to 25MB in size.
  • It is now possible to upload images with a minimum size of 1KB.

Copy url
icon
Customer Area
Improved

If there are missing information required for verification or the account holder provided invalid data, the actions that you need to take are now highlighted in the sub-merchant Overview tab.


Copy url
icon
Reports
Fixed

Card payouts now show the correct bookings in the Marketplace payment accounting report. Previously, the bookings were incorrectly duplicated as both credit and debit.


Copy url
icon
Hosted onboarding
Improved
  • We improved the accessibility of HOP to be fully compliant with WCAG 2.1 requirements.
  • When adding the same shareholder with different roles in separate instances, we will merge the entities only when they have the same KYC status. For example, if an individual has Signatory role in one instance, and Controller in another, they are shown as separate entities until they reach the same KYC status. Previously, the shareholder entries were merged by default and the lowest KYC status was shown.
Fixed

The PCI verification check is now automatically triggered when the data is entered through HOP. Previously, if the PCI questionnaire was the last to be filled out on the page, the verification process was not triggered and the PCI check showed as Awaiting data in the Customer Area.


Copy url
icon
Customer Area
New
  • We introduced the new Data provided status on the KYC tab for checks that have not passed yet, but the data was already provided for them. Previously, they were marked as Awaiting data.
  • You can now see the shareholder name, as well as their code, in the Status column for the checks on the KYC tab. If you configured your account to mask sensitive data, the names will be masked on this page as well.

Copy url
icon
API
Deprecated

The ownerDateOfBirth field is deprecated. If your integration still uses this field, make sure to send the values in a yyyy-mm-dd format to avoid validation errors. For example, 2000-01-31.


Copy url
icon
Hosted onboarding
Fixed

HOP now collects ID numbers for individuals with a Singaporean nationality. Previously, HOP showed the ID number as required but did not have the corresponding field to collect the data.

Improved

When an account holder is required to upload a document, HOP now shows a button on the overview page that will take them to the upload document section.


Copy url
icon
KYC
Fixed

We now support new area codes for US telephone numbers. Previously, the API and the hosted onboarding page returned errors for valid area codes such as 689.

Improved

We improved the validation process of phone numbers to automatically fix incorrect but "fixable" numbers. For example, if an international number starts with 0 that is only relevant for local numbers, we remove it and store only the correct international version.


Copy url
icon
Classic Platforms
Fixed

When you suspend an account holder, their payouts are blocked. However, the corresponding ACCOUNT_HOLDER_STATUS_CHANGE notification didn't reflect this payout status. We fixed this so now you'll see accountHolderStatus.payoutState.allowPayout is set to false.


Copy url
icon
API
Fixed
  • The validation on the name.infix field is now working as expected. The value must:
    • Have a maximum length of 20 characters.
    • Not contain numbers.
    • Not contain the following special characters: :;}{$#@!|<>%^*+=�\
  • When creating an account holder and the Unicode character \u0000 is included in the legalBusinessName field, this causes issues later on in the verification process. To avoid these issues, we now check this character and return an error message in the API response.
  • When you suspend an account holder, their payouts are blocked. However, when you make a /getAccountHolder request, the payout status was not reflected. We fixed this so now the accountHolderStatus.payoutState.allowPayout is set to false.

Copy url
icon
Hosted onboarding
Improved

To ensure that the documents uploaded by account holders are fully processed before moving on to the next step, HOP now redirects them to the main overview page after 10 seconds. On the overview page, they will see the status of the document upload.


Copy url
icon
Hosted onboarding
Improved

When more than one currency is supported in a country, HOP now shows the local currency first in the Bank details page. For example, when providing a GB bank account, GBP is shown before EUR.


Copy url
icon
API v6
Fixed

When sending the /getAccountHolder request, the verification.accountHolder.checks.type now returns the expected PAYOUT_METHOD_VERIFICATION value instead of the previous BANK_ACCOUNT_VERIFICATION.


Copy url
icon
API v4
Fixed

When providing an ID of a signatory, the personalData.documentData.number is now returned in the response of the POST /createAccountHolder request.


Copy url
icon
Hosted onboarding
Improved

When submitting the personal details of ultimate beneficial owners on HOP, account holders can now select any country when providing their nationality.


Copy url
icon
Customer Area
Fixed

You can now download the back side of an identification document from the Documents tab of an account holder in your Customer Area. Previously, the front image was downloaded instead.


Copy url
icon
KYC
Improved

Account holders operating in Guernsey and Jersey can now be onboarded with their GB bank accounts. This change also applies to account holders operating in the UK—they can now be onboarded with their GG and JE bank accounts.


Copy url
icon
General
Improved

When you top up accounts with the /debitAccountHolder endpoint, we now send the name of your Adyen company account to the account holder's bank. This is shown in their bank statement.

Fixed

When creating liable accounts, the accounts now follow your platform's default payout schedule. Previously, the payout schedule was always set to daily.


Copy url
icon
Hosted onboarding
New

New supported language: Croatian.

Fixed

Account holders can now add USD as a payout currency for Canadian bank accounts.

Improved
  • Account holders can now see updated verification check statuses within the same HOP session. Previously, you had to get a new HOP URL to get the updates.
  • Account holders operating in Cyprus can now provide postal codes with 5 digits.
  • Account holders can now add an additional business address for a different country than the already provided address.

Copy url
icon
Reports
New

We introduced a new ReCredited journal type to indicate the settlement of the reversal of a reversed credit.


Copy url
icon
Hosted onboarding
New

Your account holders can now select multiple roles for an individiual when providing their information in the Personal details section on HOP.


Copy url
icon
Reports
New

It is now possible to mask all but the last four characters of the bank account numbers and IBANs in Adyen for Platforms reports. Contact our Support Team to enable this feature for your platform.


Copy url
icon
General
New

You can now request our Support Team to set the pspReference of the payout as the payout descriptor in your platform. This reference is included in your account holders' bank statements, and you can use it to link a payout to the corresponding report.


Copy url
icon
Hosted onboarding
Improved

Account holders can now provide bank account numbers up to 19 digits in length.


Copy url
icon
Hosted onboarding
New
  • You can now use HOP to onboard account holders operating in New Zealand.
  • When providing information about controllers, the Email address and Phone number are now required.
Fixed

We fixed an issue where account holders with a business legal entity type cannot provide bank account details on HOP if they didn't provide their complete company address.


Copy url
icon
API
Fixed
New

You now pay out an account's the full balance to the account holder without specifying the exact amount. When sending the /payoutAccountHolder request, you only need to provide the following parameters:

  • accountCode
  • accountHolderCode
  • amount.currency (if there are multiple currencies to pay out)

Copy url
icon
Customer Area
Fixed

The Merchant reference provided when transferring funds through the Customer Area is now shown in the Transactions tab of the selected sub-merchant.

New

It is now possible to mask all but the last four characters of the bank account numbers and IBANs in the Customer Area. Contact our Support Team to enable this feature for your platform.


Copy url
icon
Hosted onboarding
Improved

It is now possible to change the legal entity type in the Business details (for businesses, non-profits, public companies, and partnerships) or Personal details (for individuals) section of the HOP. Contact our Support Team to enable this feature for your platform.

Fixed

We fixed issues with uploading a logo to HOP.

New
  • Account holders can now remove a previously added parent company through HOP. Once a parent company is deleted, all related verification checks will be removed as well.
  • You can now redirect account holders directly to the bank account page where they get the verification results instantly. To do this, send the following new fields in your POST /getOnboardingUrl request:

    {
      "showPages": { 
        "checksOverviewPage": false, 
        "bankVerificationPage": true 
      }
    }

Copy url
icon
Hosted onboarding
New

You can now limit new account holders to add only a single bank account. Once this feature is enabled, those that already have multiple accounts can still view and update their bank details, but they will not be able to add new accounts. Contact our Support Team to enable this feature for your platform.

Fixed

Account holders can now change the role (owner, controller, or signatory) of individuals associated with an organization in the Role dropdown menu of the Personal details page.


Copy url
icon
API
New

You can now delete an existing listedUltimateParentCompany object by sending an /updateAccountHolder request and setting the value of the object to null.


{
    "accountHolderCode": "ACCOUNT_HOLDER_CODE",
    "listedUltimateParentCompany": null
}

Copy url
icon
Hosted onboarding
Fixed

We fixed issues where some words were not translated to the selected languange.


Copy url
icon
Customer Area
Fixed

Previously, the Customer Area would still show a schedule even when scheduled payouts are disabled for your whole platform. If this is the case for your platform, you'll now find HOLD as the payout schedule.


Copy url
icon
Hosted onboarding
New

The Job title is now a required field when providing information about controllers and signatories.


Copy url
icon
Classic Platforms
Improved

You will now receive the ACCOUNT_HOLDER_PAYOUT notification with statusCode Confirmed if the card payout is processed successfully, and Failed if the payout fails.


Copy url
icon
API
New

You can now delete an existing principalBusinessAddress object by sending an /updateAccountHolder request and setting the value of the object to null.

{
    "accountHolderCode": "ACCOUNT_HOLDER_CODE",
    "principalBusinessAddress": null,
    ...
}

Copy url
icon
Hosted onboarding
Improved

The instant bank verification flow is now part of the page itself. Account holders can now verify their banking information within the page instead of in a pop-up window.


Copy url
icon
Hosted onboarding
Fixed

In the header, clicking on the FAQs or the Contact links is working as expected again.


Copy url
icon
API
Fixed

When the phoneNumber object is missing required fields, the API now returns an error. Previously, the API accepted the request but the account holder setup failed at a later time.


Copy url
icon
API
Improved
  • When providing information for the listedUltimateParentCompany object, now you only need to send the address.country parameter instead of the whole address.
  • We made the houseNumberOrName field optional, because in some countries, building and house numbers are already included in the street address. You can now include the building or house numbers in the street field.

Copy url
icon
General
New

You can now onboard sub-merchants operating in New Zealand.


Copy url
icon
Hosted onboarding
Improved
  • We increased the size of logos shown on onboarding pages that do not have a header. Previously, the logos were less noticeable because they were smaller.
  • To make providing addresses more intuitive for account holders, they can now include their house or building number in the Street field. The House/unit number field is now optional.

Copy url
icon
General
Improved

We improved how we handle funds when an account holder's status changes to suspended or closed.

  • Existing funds
    • Old: Existing funds were refunded by default.
    • New: The default handling is the same as before, but now you can contact our Support Team to automatically transfer the funds to your liable account instead of refunding.

  • New payments (if payments for an already suspended or closed account holder were processed)
    • Old: The payments were automatically refunded by default.
    • New: The default handling is the same as before, but now you can contact our Support Team to automatically transfer the funds to your liable account instead of refunding.

  • Chargebacks and refunds
    • Old: Refunds and chargebacks were deducted from a suspended or closed account holder's account by default.
    • New: Refunds and chargebacks are deducted from your liable account by default.

These changes do not affect payouts. Only active account holders are allowed to get payouts.


Copy url
icon
API
New

We added the new payoutMethodReference parameter to the Account API. In this field you can provide your own reference to the payoutMethod, which allows easier mapping to the payoutMethodCode.


Copy url
icon
Customer Area
Improved

We created a new user role specifically for downloading payout letters in Customer Area. Until now, you had to assign the extensive Merchant Extended MarketPlace role to users to permit Customer Area users to download the payout letter containing the bank transfer details. To avoid having to give users more access to your platform than necessary, you can assign the Allow the user to download the payout confirmation letter role.


Copy url
icon
Hosted onboarding
Improved

Customer Area users that have a Manage HOP settings user role can now access HOP on behalf of an account holder by default. Previously, this feature had to be requested and enabled for each platform.


Copy url
icon
Customer Area
Fixed

When the Unsuspend Account Holder button is not available and you hover over it, we used to always show this tooltip: The account holder has been permanently suspended due to FAILED KYC verification check(s).

We fixed this so now you only see this tooltip when one of the KYC checks failed. You will no longer see this when the account holder has been suspended because they sent invalid data or they are still awaiting KYC checks.


Copy url
icon
KYC
Changed

When onboarding account holders that are part of legal arrangements, you now only need to collect and upload a document if:

  • The account holder is part of a trust in Australia.
  • The automatic verification failed and Adyen required the account holder to provide a document.

Previously, uploading a document was required for all legal arrangement types.


Copy url
icon
Hosted onboarding
New

We now support the following languages on HOP:

  • Czech
  • Hungarian
  • Romanian

For instructions on how to render HOP in your preferred language, refer to Change the page language.


Copy url
icon
API
New
  • Added the listedUltimateParentCompany array in all API version. You can now use this array to send information about account holders' parent companies. Previously this was only available in v6.

Copy url
icon
API v6
New

Copy url
icon
Hosted onboarding
New
  • Added the showPages object, which contains booleans. You can use these booleans to indicate whether HOP should show summary pages to account holders.

Copy url
icon
API
New
  • Added the /deleteSignatories endpoint, which you can use to delete one or more signatories from an account holder.

Copy url
icon
API v6
New
  • Added the legalArrangements array, which contains information such as the registration number and entities involved in the legal arrangement. You must send this when onboarding account holders involved in legal arrangements.

Copy url
icon
API
New

Copy url
icon
General
New
  • You can now onboard account holders operating in Singapore and more countries within the EU. See Supported countries.

Copy url
icon
Hosted onboarding
New
  • Added the collectInformation object, which contains booleans. You can use these booleans to indicate whether HOP should only collect information for specific KYC checks.

Copy url
icon
API
Fixed

When splitting payments for local payment methods such as iDEAL, the /payments endpoint now returns a validation error if the sum of split amounts is not equal to the payment amount. The endpoint previously accepted these requests and this caused an issue in settling funds.


Copy url
icon
Hosted onboarding
New

You can now use HOP to onboard account holders operating in Latvia.


Copy url
icon
API
New

Copy url
icon
Customer Area
New

In the overview of account holders in your Customer Area, you can now search by PSP reference.


Copy url
icon
General
Improved

After a payout is unblocked, we restore the payout schedule for the account holder. In case the account holder has multiple accounts, we restore all payout schedules.


Copy url
icon
Reports
Improved

We extended the Marketplace Hourly Payments Accounting Report with more chargeback details. Partial chargebacks entries with a ChargebackReversed record type now include information in the Payment Psp Reference and Payment Merchant Reference columns.

Fixed

We now make sure that the ChargebackReversed correction is applied to all splits for your platform and account holders.


Copy url
icon
General
Improved

When adding an account to the split instructions, we now check whether the store and the account have the same account holder. This prevents split payments going to an unrelated account holder.


Copy url
icon
KYC
Improved

We now collect the Principal place of business address when this differs from the Registered address for the following legal entity types: Business, NonProfit, PublicCompany, and Partnership. To send this address, include the principalBusinessAddress object when creating or updating the account holder.


Copy url
icon
Hosted onboarding
Improved

The bank statements page now allows uploading a bank statement for solo-traders or freelancers who have their bank accounts under their business name. This prevents KYC checks failing because of the mismatch between their bank statement and the individual details that they provide.


Copy url
icon
General
Improved

We can enable a feature which ignores the pending balance from the calculation of the payout to account holders.


Copy url
icon
API
Improved

When creating a store with a shopperInteraction Ecommerce, you no longer need to provide the fullPhoneNumber and webAddress. Instead, we'll take this data from the account holder.


Copy url
icon
General
Fixed

We now only create scheduled payouts on bank days. Previously, we allowed creating scheduled payouts every day, which sometimes resulted in two payouts in one day.


Copy url
icon
API
Improved

We now allow point-of-sale stores to make changes to storeReference, storeFullPhoneNumber and address.

Fixed

There are no more duplicate API keys (in test or live) saved for marketplace web service users.


Copy url
icon
Classic Platforms
Improved

If a payout fails due to insufficient funds in the liable account, you now receive this information in the description within the ACCOUNT_HOLDER_PAYOUT notification. Previously the description was Internal error.


Copy url
icon
API
Fixed
  • Setting payoutSchedule to DEFAULT now works in a /createAccount call. Previously it was throwing an exception, preventing the account to be created.
  • Previously when a payout request times out due to KYC not being available, we showed Internal Error and Invalid Input errors. The response now only shows Internal Error.
Improved

We improved the description for verification error code 2130 for /updateAccountHolder. Instead of Invalid data, the new description now says that the business registration, company name, or shareholder data is incorrect or can't be verified.


Copy url
icon
Hosted onboarding
Improved
  • On HOP, we now specify that a bank cheque is only supported in specific regions. We added this to inform sellers to avoid uploading bank cheques as a valid proof of bank requirements when not supported for their region.
  • We specified on HOP that the name should be the same as the first and last name shown on their identification document to avoid KYC failures.

Copy url
icon
KYC
New

We added front end validations on all missing or wrong fields for the payment method creation.


Copy url
icon
Classic Platforms
New

We can now send notifications if the funds on the liable account hit a certain threshold. To receive the notification, subscribe to the ACCOUNT_FUNDS_BELOW_THRESHOLD notification.


Copy url
icon
Hosted onboarding
Improved

HOP now renders the seller summary page and allows the account holder to edit their personal details any time the identity verification fails.


Copy url
icon
API
New

You can now have multiple onboarding approaches for your sub-merchants, so one sub-merchant can go through an upfront verification and another with a staggered approach. To set the onboarding approach, include the verificationProfile in the /createAccountHolder and /updateAccountHolder requests.


Copy url
icon
Classic Platforms v6
New
  • When a sub-merchant payout is returned, we now send the return reason in the ACCOUNT_HOLDER_PAYOUT notification.

    Error code Message
    10_132 Invalid Account Number
    10_133 Invalid Routing Number
    10_134 No Account
    10_135 Account Closed
  • We added new fields to the content of the ACCOUNT_HOLDER_PAYOUT webhook with status Confirmed, containing information on the payout you can send to the sub-merchant to provide more details and help with troubleshooting.

    Parameter Description
    payoutReference The unique payout id.
    payoutAccountNumber The account number of the bank from which the payout is initiated.
    payoutBranchCode The branch code of the bank from which the payout is initiated.
    payoutAccountCountry The country code of the bank from which the payout is initiated.
    payoutBankName The name of the bank the payout is made from.
Changed
  • In the ACCOUNT_HOLDER_CREATED and ACCOUNT_HOLDER_UPDATED notifications, we renamed the following:
    • verification.bankAccountsto verification.payoutMethods
    • verification.bankAccounts.bankAccountUUID to verification.payoutMethods.payoutMethodCode
  • In the ACCOUNT_HOLDER_VERIFICATION notification, we have renamed content.bankAccountUUID to content.payoutMethodCode.
Removed

Copy url
icon
API v6
New
  • Stores can now be updated through the /updateAccountHolder endpoint, by including the store field in the request.
  • You can now use the Partnership legal entity for Partnerships, for example, German GbR entities. A Partnership is similar to the Business legal entity except that a registrationNumber is optional for a Partnership. It is available only for Germany and the United Kingdom.
Changed

We renamed verification.bankAccounts to verification.payoutMethods and verification.bankAccounts.bankAccountUUID to verification.payoutMethods.payoutMethodCode in the response of the /createAccountHolder, /updateAccountHolder, /getAccountHolder, and /uploadDocument endpoints.


Copy url
icon
Customer Area
New

We renamed MarketPay to Adyen For Platforms in the Adyen Customer Area.


Copy url
icon
Classic Platforms
Improved
  • If creating the account holder fails, the accountHolderCode is now included in the ACCOUNT_HOLDER_CREATED notifications.
  • If you have not specified a schedule in the /createAccount request, the payoutSchedule field in the ACCOUNT_CREATED notification is now populated with the set default payout schedule instead of null.

Copy url
icon
Classic Platforms
Improved

If the payout has been blocked by Adyen, the message will now specify that the payout has been blocked by Adyen to make it clear that it was not intentionally blocked by the merchant.


Copy url
icon
Hosted onboarding
New

You can now add a Support button on your page to redirect the account holder to your support page. Contact our Support Team to have this enabled.


Copy url
icon
API
New

We added two new fields which are required when legalEntity is publicCompany:

  • stockExchange
  • stockNumber

Copy url
icon
Classic Platforms
New

We added the returnReason for a failed payout in the Adyen Customer Area. You can find this under the Transactions list per account holder. We have also added the return reason to the ACCOUNT_HOLDER_PAYOUT notification.


Copy url
icon
General
New
  • If an account holder adds a bank account that is already being used by another account holder, they are now pushed to the highest tier.
  • We now allow the shareholder country to be different from the country of the business entity.

Copy url
icon
Classic Platforms
Fixed

We fixed an issue where express payout attempts did not work, even though you received a successful ACCOUNT_HOLDER_PAYOUT notification.


Copy url
icon
API
Fixed

Corrected the mapping of verification codes. Code 1161 will be used for photo ID verification, and code 3163 will be used for bank account verification.


Copy url
icon
General
Improved

You can now transfer funds between accounts that belong to the same account holder, regardless of the account holder's payout status.


Copy url
icon
Reports
Improved

Partial captures that do not have split instructions are now credited to the liable account with the description "Payment with empty split data".


Copy url
icon
API
Fixed

Fixed an issue where PASSPORT_VERIFICATION checks were set to AWAITING_DATA instead of INVALID_DATA.


Copy url
icon
Classic Platforms
Fixed

The ACCOUNT_HOLDER_UPDATED notification now includes bankAccountReference if removing Personal Identifiable Information (PII) data is enabled for your platform.


Copy url
icon
Customer Area
Fixed

The filters used in the Customer Area to view a list of account holder now also applies to the downloaded report.


Copy url
icon
API
Improved

The /getAccountHolder response now returns all verification statuses. In versions before v5, the response only contains the required and passed checks.


Copy url
icon
Classic Platforms
Improved

Added validation on the partial captures. If you submit a partial capture without split instructions, we'll send a capture notification with success = false and reason: Incomplete split payment data provided: Partial captures on payments with split instructions are not supported.

Fixed

Fixed an issue where the ACCOUNT_HOLDER_VERIFICATION notification was not sent when the identity verification status changed from INVALID_DATA to DATA_PROVIDED.


Copy url
icon
General
Fixed

Transferring funds between two accounts that belong to the same account holder no longer increases the processed volume.


Copy url
icon
API
Fixed

Verification check status for COMPANY_VERIFICATION is now set to PENDING when uploading a company extract using the /uploadDocument call.


Copy url
icon
Classic Platforms
Improved

We now send an ACCOUNT_HOLDER_PAYOUT notification when a validation error occurs on the /payoutAccountHolder call. This now applies to versions earlier than v5 as well.


Copy url
icon
API
Improved

In the /checkAccountHolder request, we now validate if the payout or processing tier is not lower than or equal to the current tier of the account holder. If this validation fails, you can receive the following errors:

  • 80: The provided Payout or Processing tier cannot not be lower than or equal to the account holder's current Processing tier.
  • 81: The provided Payout tier cannot not be lower than or equal to the account holder's current Payout tier.

Copy url
icon
Customer Area
New

The "On Hold Balance" is now available in the MarketPay balance report.
To enable this functionality, contact our Support Team.


Copy url
icon
API
Fixed

Updating a shareholder with an incorrect shareholder code will result in a validation error: errorCode = 70 Message = "Shareholder does not exist for shareHolderCode: {0}."


Copy url
icon
Reports
Fixed

The exchange rate column in the Marketplace Payments accounting report is now populated.


Copy url
icon
API
New

You can now upload supporting documents by sending COMPANY_REGISTRATION_SCREENING document type in the /uploadDocument request.


Copy url
icon
API
Improved

Improved the order of validations for the /payoutAccountHolder call. The error There is not enough balance available for account {0}. Available balance: {1}; Payout amount: {2}. is now returned before the Payout limit reached the account limit. error.

Changed

You can now change the payout descriptor for automatic payouts.


Copy url
icon
Reports
Fixed

Corrected the Main Amount column for Express Payouts in the Marketplace Payments accounting report.


Copy url
icon
General
New

We added Lithuania to the countries we support.


Copy url
icon
Classic Platforms
Fixed

The merchantReference is populated in the ACCOUNT_HOLDER_PAYOUT notification if the API version and the notification version are different. For example, API v3 and notification v5.

Improved

When a request fails on the central system, the accountHolderCode or accountCode is now returned in the notifications.


Copy url
icon
API
Changed

The email is no longer required for shareholders.


Copy url
icon
Customer Area
Improved

You can now make partial refunds on specific split items in your Customer Area.


Copy url
icon
General
Fixed

A PayoutReturned to a source account of a beneficiary setup is now booked to the destination account.


Copy url
icon
API v5
Fixed

You can now change the legal entity type to business with multiple shareholders.


Copy url
icon
KYC
Changed

The retry limit on a verification check is reset (set to zero) when an account holder passes the verification check.


Copy url
icon
Customer Area
Improved

Added a link to the destination and/or source account in the sub-merchant transaction list.


Copy url
icon
API
Fixed

When you make a /createAccountHolder call with incomplete documentData, the request will be refused.


Copy url
icon
API
Fixed

When using the /refundNotPaidOutTransfers for an account in a beneficiary setup, the transactions on destination account are now refunded.


Copy url
icon
General
Changed

We've lowered the minimum allowed size for uploaded bank statements (in jpeg, jpg, and png) from 100kB to 10kB.


Copy url
icon
API
Improved

When an /updateAccountHolder or a /createAccountHolder request includes a phone number for the shareholder and the account itself, these two get recorded separately.


Copy url
icon
Classic Platforms
Fixed

ACCOUNT_HOLDER_VERIFICATION notifications with verificationStatus: INVALID_DATA no longer contain a requiredFields object.


Copy url
icon
Hosted onboarding
New

The page now includes a field for the Photo ID, so that you can simulate tier 3 verification in test.


Copy url
icon
Classic Platforms
Fixed

The ACCOUNT_HOLDER_UPDATED notification now includes an error message when you try to update an account holder's bank account but the bankAccountUUID does not exist.


Copy url
icon
API
Changed

When making a /createAccountHolder call, you can now pass fullPhoneNumber instead of email.

Fixed

/getUploadedDocuments no longer returns documents of deleted bank accounts.


Copy url
icon
API
Changed

We renamed the /verify endpoint to /checkAccountHolder.


Copy url
icon
API
Fixed

When the amount in a splits array is assigned a float value, you now get the following error message: Invalid additionalData field split.item1.amount.


Copy url
icon
KYC
Changed

When you unsuspend an account holder after they got suspended because of missing the KYC deadline, they now have to submit the required information within 42 days, or they will get suspended again.


Copy url
icon
General
New

We added Greece to supported countries.


Copy url
icon
API
Fixed
  • /getUploadedDocuments now only returns the latest document of a check type.
  • When you pass an empty object in an API call, this object is no longer returned in the response.

Copy url
icon
API
Changed

When providing bank account information, you no longer need to pass bankAccount.countryCode. We now get the country from the address.country field.


Copy url
icon
Reports
Fixed

We fixed an issue that caused the hourly Payment accounting report to miss some data.


Copy url
icon
Customer Area
Changed
  • When refunding a split payment, the refund now has as its reference the split item Reference, not the authorisation reference as before.
  • The date format for the account holder transaction export is now: yyyy-MM-dd HH:mm:ss.

Copy url
icon
API
Fixed

We improved the flow for updating an account holder shortly after creating it.


Copy url
icon
KYC
Fixed

The 1501 KYC verification codes in the KYC timeline now show the full description.


Copy url
icon
Customer Area
New

You can now initiate fund transfers from your Customer Area.

Improved

Account holder level metadata is now displayed on the account holder overview page.


Copy url
icon
API v5
Changed

The /updateAccountHolder response and the ACCOUNT_HOLDER_UPDATED notification now include the payoutInstrumentTokens.


Copy url
icon
API
Changed
  • Underscore is now allowed in the accountHolderCode parameter.
  • When refunding by using the /refundNotPaidOutTransfers call, you now have the option to use the authorisation reference as a reference for the refund.
Removed

You can no longer set up a beneficiary when the source account is suspended.


Copy url
icon
Classic Platforms
Fixed

The ACCOUNT_HOLDER_UPDATED notification is now also triggered by the /deleteBankAccounts and /deleteShareholders requests.


Copy url
icon
Customer Area
Fixed

The description of a payout in the transaction list no longer contains a JSON object.


Copy url
icon
Customer Area
Improved

The transaction list now displays the description of a payout.


Copy url
icon
API
New

You can now consistently hide personally identifying information (PII) across API responses and notifications.
To enable this functionality, contact our Support Team.

Fixed

/getUploadedDocuments no longer returns documents from deleted shareholders.


Copy url
icon
Customer Area
Improved

We improved the design of the sub-merchant list in your Customer Area for smaller screen sizes.


Copy url
icon
API
Improved

We now only reject duplicate document uploads for the documents that are active for this account holder.

Fixed

Fixed a bug that changed the bankAccountUUID and shareholderCode for marketplaces that had enabled the GDPR setting.


Copy url
icon
Classic Platforms
Fixed

Notifications now include the error message in addition to errorCode.


Copy url
icon
Reports
Improved

You can now retroactively generate the Marketpay Balance Report.


Copy url
icon
Customer Area
Improved

Payments in the sub-merchant's transaction list now display the full transaction history in a single payment line.


Copy url
icon
API
Fixed
  • We no longer match duplicate bank account for account holder on just the accountNumber, but also include the branchCode.
  • We fixed an issue that would push an account holder in the highest tier when multiple /updateAccountHolder requests added the same bank account.

Copy url
icon
API
Improved

We added refusal reasons for automatic bank verification for US bank accounts.

Refusal reason code Description
3111 The routing number provided is incorrect. Provide the correct ABA routing number associated with this account. 1
3112 The account number provided is incorrect. Provide the correct account number.
3113 This institution is not programmatically covered. Use a different financial institution or upload a copy of your bank statement.
3114 This institution is not eligible for payouts on MarketPay. Provide a different bank account.

Copy url
icon
KYC
Improved

We improved bank account verification rates in Germany for when an account holder only provides account number and branch code instead of the IBAN.


Copy url
icon
API v5
Improved

The /getAccountHolder response now contains system up to date time.


Copy url
icon
Reports
Improved

You can now generate MarketPay reports in bulk.
To enable this functionality, contact our Support Team.


Copy url
icon
Customer Area
New

You can now pay out to an account holder from the Customer Area.
To enable this functionality, contact our Support Team.


Copy url
icon
Classic Platforms
Fixed

The PSP reference in the ACCOUNT_HOLDER_PAYOUT notification now matches the PSP reference in the Marketplace Payment accounting report.


Copy url
icon
API
Improved

We added security features to the Adyen for Platforms API credentials such as X-API-KEY, IP restriction, and adding a client certificate.

Fixed

The /updateAccountHolder request no longer fails if made shortly after a /createAccountHolder request.


Copy url
icon
Customer Area
Fixed

We fixed a display issue of account holder date of birth.


Copy url
icon
Reports
Improved

MarketPay balance report: Added two columns to the report displaying the Pending Credit and Pending Debit amounts.

Removed

We removed the MarketPay End of Month Balance Report. You can now get the data from this report in the Marketpay Balance Report.


Copy url
icon
API
Fixed

We fixed a bug where a returned payout for an account holder was not correctly deducted from the total paid out amount.


Copy url
icon
API
Fixed
  • We fixed an issue where the COMPANY_VERIFICATION returned AWAITING_DATA instead of PENDING.
  • We fixed a bug that caused BANK_ACCOUNT_VERIFICATION to stay in PENDING status.

Copy url
icon
Customer Area
New

The transaction list on the account holder page now contains an estimated time of arrival for payouts.

Improved
  • The Upcoming deadline on the account holder overview page now contains the year, in addition to month, day, and time.
  • Payments list - You can now also refund the commission or payment fee part in the split payment through the Customer Area.
Fixed
  • The account holder deadline date is now displayed correctly.
  • The account holder transaction list now starts from 1 instead of 0.

Copy url
icon
Classic Platforms v5
New
  • You can now enable HMAC signatures as an extra layer of security for your notification webhooks.
  • All notification types now include a root-level error object that contains errorCode and message. This new object contains both validation and server errors.
  • In all notification types, you can now see which fields are invalid or missing in the content.invalidFields array.

Copy url
icon
API v5

For guidance on upgrading to this version, refer to the migration guide.

Breaking Changes
  • All create, update, and delete requests are now handled asynchronously. Your integration must use notification webhooks to get the outcome of your requests.
  • When making a /createAccountHolder request to create an account holder of legalEntityType business, the country field is now required.
  • We renamed the /verify endpoint to /checkAccountHolder.
Improved
  • We implemented more granular KYC verification error codes to help you determine which type of check the error is for. We divided the error codes into the following categories:

    • Photo ID verification: Error codes starting with 11xx.
    • Identity check: Error codes starting with 13xx.
    • Company verification: Error codes starting with 21xx.
    • Bank account verification: Error codes starting with 31xx.
New
  • You can now update the legal entity type of an existing account holder.
  • You can now upload supporting documents by sending COMPANY_REGISTRATION_SCREENING document type in the /uploadDocument request.
  • When adding payout methods, you can now include your own payout method reference in the payoutMethodReference field.
  • We added the following endpoints:
    • /checkAccountHolder

      Use this endpoint to trigger account holder verification earlier than required by the currently processed volume.

    • /deletePayoutMethods

      Use this endpoint to delete payout methods of an existing account holder.