Search

Are you looking for test card numbers?

Would you like to contact support?

Marketpay icon

Release notes

Learn about the latest updates to Adyen for Platfoms.

February 2021

February 15

Fixes

  • When splitting payments for local payment methods, 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.

February 8

New

  • We introduced a jobTitle field in the shareholder object. If the shareholderType is Controller, then jobTitle is required.

  • You can now use the /getPciQuestionnaireUrl endpoint for individual and nonprofit legal entity types.

  • HOSTED ONBOARDING The Hosted Onboarding Page (HOP) now supports Latvian account holders.

January 2021

January 27

New

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

Improvements

  • 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.

January 13

New

  • We extended the marketplace hourly payments accounting report with more chargeback details:
    Partial chargebacks with a ChargebackReversed journal now include Payment Psp Reference and Payment Merchant Reference columns.

Improvements

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

Fixes

  • We now make sure that the ChargebackReversed correction is applied to all splits for the marketplace and sub-merchants.

January 6

Improvements

  • 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.

November 2020

November 25

New

  • When an account is suspended, the account holder's account details now indicate why, with one of these static fields:
    • suspendedbyplatform
    • suspendedbykyc
    • suspendedmissingdeadline

Improvements

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

  • HOSTED ONBOARDING The bank statement's webpage now allows uploading a bank statement for solo-traders or freelancers who have their bank accounts under their business name. This prevents a mismatch between the bank statement and the individual details provided.

November 11

Improvements

  • You no longer need to provide a phone number and web address in the store object. Instead, we'll take this data from the account holder. If not yet available, we'll show an error that the fields are missing. This only applies if shopperInteraction is Ecommerce.

October 2020

October 28

Fixes

  • 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.

October 21

Improvements

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

Fixes

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

September 2020

September 21

Improvements

  • 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.

  • 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.

Fixes

  • 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.

August 2020

August 31

Improvements

  • HOSTED ONBOARDING The Hosted Onboarding Page (HOP) specifies that a bank cheque is only supported in specific regions. This helps inform sellers to avoid uploading bank cheques when not supported as a valid proof of bank requirements.

  • We have specified on HOP that the name should be identical to the first and last name shown on the identification document to avoid KYC failures.

August 17

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.
  • We have added front end validations on all missing or wrong fields for the payment method creation.

August 8

Improvements

  • HOSTED ONBOARDING When using the Hosted Onboarding Page (HOP), we now render the seller summary page in order to allow the user to edit the personal details at any time the identity verification fails.

July 2020

July 27

New

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

Improvements

  • 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.

July 20

Improvements

  • Adyen Customer Area improvement: 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.

July 6

New

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

    • stockExchange
    • stockNumber
  • HOSTED ONBOARDING You can now add a 'support' button on the Hosted Onboarding Page (HOP) which will provide a redirection to your support page. Contact our Support Team to have this enabled.

June 2020

June 29

New

May 2020

May 26

Fixes

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

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.

May 19

Improvements

May 12

New

November 2019

November 4

Fixes

October 2019

October 29

October 21

Improvements

  • Partial captures that do not have split data are now booked on the liable account with the description "Payment with empty split data".

October 14

Fixes

  • Fixed an issue that caused passport verification to be set to awaiting_data instead of invalid_data.
  • The ACCOUNT_HOLDER_UPDATED notification now includes BankAccountReference when the PII removal property is enabled.

October 7

Fixes

  • CUSTOMER AREA The filters used in the Customer Area to view a list of account holder transactions will also apply to the downloaded report.

September 2019

September 30

Improvements

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

September 16

Improvements

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

Fixes

  • Transferring funds between two accounts that belong to the same account holder will no longer increase the processed volume.
  • Fixed an issue where the ACCOUNT_HOLDER_VERIFICATION notification was not sent when the identity verification status changed from invalid_data to data_provided.

September 2

Fixes

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

August 2019

August 26

Improvements

August 19

Improvements

  • Added validation to the /checkAccountHolder call. The payout or processing tier can't be lower than or equal to the current tier of an account holder. Two new validation errors have been introduced:

    • 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.

August 12

New

July 2019

July 29

Fixes

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

July 22

Fixes

July 15

New

  • The /uploadDocument call now allows you to upload supporting documents for company verification.

Improvements

  • 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}. will now be thrown before Payout limit reached the account limit.

Changes

July 8

Changes

  • We added Lithuania to the countries we support.

Fixes

July 1

Improvements

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

Changes

  • The email is no longer required for shareholders.

Fixes

  • 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.

June 2019

June 24

Improvements

  • CUSTOMER AREA You are now able to make partial refunds on specific split items in the Customer Area.

Fixes

  • Version 5 Changing the legal entity type to business with multiple shareholders is now working.
  • A PayoutReturned to a source account of a beneficiary setup is now booked to the destination account.

June 17

Improvements

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

Changes

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

Fixes

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

June 3

Fixes

May 2019

May 27

Changes

May 13

Fixes

May 6

Changes

Fixes

April 2019

April 29

Changes

Fixes

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

April 23

New

  • We added Greece to supported countries.

Changes

  • 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.

Fixes

  • /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.

April 15

Changes

  • When providing bank account information, you no longer need to pass bankAccount.countryCode, as we will use Address.country to populate this field.
  • CUSTOMER AREA When refunding a split payment, the refund now has as its reference the split item Reference, not the authorisation reference as before.
  • CUSTOMER AREA The date format for the account holder transaction export is now: yyyy-MM-dd HH:mm:ss.

Fixes

  • We fixed an issue that caused the hourly Payment accounting report to miss some data.
  • We improved the flow for updating an account holder shortly after creating it.

April 8

Changes

Fixes

April 1

New

  • For account holders in the U.S., you now have the option to only provide the last 4 digits of the Social Security Number (SSN).
  • You now have the option to only receive the last 4 digits of the SSN in the API response and notifications.
    To enable this functionality, contact our Support Team.

Improvements

  • CUSTOMER AREA When payouts for an account holder have been blocked, the reason and the date are now displayed on the account holder overview page.

Fixes

March 2019

March 25

New

  • CUSTOMER AREA You can now initiate fund transfers from your Customer Area.
    To enable this functionality, contact our Support Team.

Changes

Improvements

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

Fixes

March 18

Fixes

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

March 11

New

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

Improvements

  • CUSTOMER AREA The transaction list now displays the description of a payout.

Fixes

March 4

Improvements

  • CUSTOMER AREA We improved the design of the sub-merchant list in your Customer Area for smaller screensize.

February 2019

February 21

Improvements

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

Fixes

  • Version 5 Notifications now include the error message in addition to errorCode.
  • Fixed a bug that changed the bankAccountUUID and shareholderCode for marketplaces that had enabled the GDPR setting.

February 14

Improvements

  • Version 5 We added refusal reasons for automatic bank verification in the U.S:

    • 3111: The routing number provided is incorrect. Provide the correct ABA routing number associated with this account.
    • 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.

  • CUSTOMER AREA You can now retroactively generate the 'MarketPay balance report'.
  • CUSTOMER AREA Payments in the sub-merchant's transaction list now display the full transaction history in a single payment line.

Fixes

  • 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.

February 7

Improvements

  • Version 5 The /getAccountHolder response now contains system up to date time.
  • We improved verification rates in Germany when only accountNumber and branchCode are provided instead of the IBAN.

January 2019

January 31

New

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

Improvements

  • MarketPay reports can now be generated in bulk.
    To enable this functionality, contact our Support Team.

January 24

Improvements

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

Fixes

  • The /updateAccountHolder request no longer fails if made shortly after a /createAccountHolder request.
  • CUSTOMER AREA We fixed a display issue of account holder date of birth.
  • The PSP reference in the ACCOUNT_HOLDER_PAYOUT notification now matches the PSP reference in the Marketplace Payment accounting report.

January 17

New

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

Changes

  • We removed the MarketPay End of Month Balance Report. This data can now be retrieved from the MarketPay balance report.

Improvements

  • MarketPay balance report: Added two columns to the report displaying the Pending Credit and Pending Debit amounts.
  • CUSTOMER AREA The Upcoming deadline on the account holder overview page now contains the year, in addition to month, day, and time.
  • CUSTOMER AREA Payments list - You can now also refund the commission or payment fee part in the split payment via the Customer Area.

Fixes

  • We fixed a bug that caused bank account verification to stay in pending status.
  • We fixed a bug where a returned payout for an account holder was not correctly deducted from the total paid out amount.
  • We fixed a bug where the Company check returned AWAITING_DATA instead of PENDING.
  • CUSTOMER AREA The account holder deadline date is now displayed correctly.
  • CUSTOMER AREA The account holder transaction list now starts from 1 instead of 0.