Release notes

July 2020

July 6

New

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

  • stockExchange
  • stockNumber
• 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

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

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

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

May 12

New

• The Hosted Onboarding Page includes a field for the Photo ID, so that you can now simulate tier 3 in test.

November 2019

November 4

Fixes

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

October 2019

October 29

• It is now allowed to transfer funds between accounts that belong to the same account holder, regardless of the payout status.

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

• We'll 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.

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

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

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

• The exchange rate column in the MarketPay payments accounting report is now populated.

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

• You can now change the payout descriptor for automatic payouts.
  To enable this functionality, contact our Support Team.

July 8

Changes

• We added Lithuania to the countries we support.

Fixes

• Corrected the main amount for Express Payouts in the MarketPay payments accounting report.

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

• Refund last transactions will refund the transactions on the destination account of a beneficiary setup.

May 2019

May 27

Changes

• The minimum allowed size for uploaded bank statements (in jpeg, jpg, and png) is lowered from 100kB to 10kB.

May 13

Fixes

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

May 6

Changes

• When making a /createAccountHolder call, you can now pass fullPhoneNumber instead of email.
  To enable this functionality, contact our Support Team.

Fixes

• Version 5 We added an error message to the ACCOUNT_HOLDER_UPDATED notification when you tried to update an account holder's bank account with a nonexistent UUID.
• /getUploadedDocuments no longer returns documents of deleted bank accounts.

April 2019

April 29

Changes

• Version 5 We renamed the /verify endpoint to: /checkAccountHolder .

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

• When making a /createAccountHolder or an /updateAccountHolder call with country set to IT, you no longer need to provide StateOrProvince.

Fixes

• The response to a /testNotificationConfiguration request now includes all relevant fields for the notification.

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

• The ACCOUNT_HOLDER_STATUS_CHANGE notifciation no longer has an old event in the newStatus object.

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

• Underscore is now allowed in the accountHolderCode.
• When refunding by using the /refundNotPaidOutTransfers call, you now have the option to use the authorisation reference as a reference for the refund.
  To enable this functionality, contact our Support Team.
• Version 5 The /updateAccountHolder response and the ACCOUNT_HOLDER_UPDATED notification now include the payoutInstrumentTokens.

Improvements

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

Fixes

• You can no longer set up a beneficiary when the source account is suspeneded.
• The ACCOUNT_HOLDER_UPDATED notification is now also triggered by the /deleteBankAccounts and /deleteShareholders requests.
• CUSTOMER AREA The 1501 KYC verification codes in the KYC timeline now show the full description.

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

• /getUploadedDocuments no longer returns documents from deleted shareholders.

March 4

Improvements

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

February 2019

Februrary 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 MarketPay web service user 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.