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 is unable to 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
- When using the Hosted Onboarding Page (HOP), we now specify 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
- 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 ofnull
.
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
- 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 code3163
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 toawaiting_data
instead ofinvalid_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
todata_provided
.
September 2
Fixes
- Verification check status for
COMPANY_VERIFICATION
is now set toPENDING
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 errorThere is not enough balance available for account {0}. Available balance: {1}; Payout amount: {2}.
will now be thrown beforePayout 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
oraccountCode
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 arequiredFields
object.
May 6
Changes
- When making a /createAccountHolder call, you can now pass
fullPhoneNumber
instead ofemail
.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 useAddress.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 provideStateOrProvince
.
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
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
andshareholderCode
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 thebranchCode
. - 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
andbranchCode
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.