{"title":"Onboarding versions","category":"default","creationDate":1739180100,"content":"<p>This page explains onboarding versioning and what you need to do in order to <a href=\"#update-version\">update to the latest onboarding version<\/a>. We recommend that you update to the latest version as soon as possible to take advantage of new features and meet compliance requirements. The latest stable onboarding version is v4. For more information about onboarding v4, see the <a href=\"\/pt\/marketplaces\/onboard-users\/onboarding-versions\/onboarding-v4\">v4 overview page<\/a>.<\/p>\n<h2 id=\"onboard-versions\">Onboarding versioning<\/h2>\n<p>An onboarding version includes any breaking changes related to:<\/p>\n<ul>\n<li>Legal Entity Management API<\/li>\n<li><a href=\"\/pt\/marketplaces\/onboard-users#hosted-onboarding\">Hosted onboarding<\/a><\/li>\n<li>Know your customer (KYC) verification checks<\/li>\n<\/ul>\n<p>If a breaking change needs to be made in any of these three areas, we introduce this as part of a new onboarding version. However, an onboarding version does not necessarily include changes in all three areas.<\/p>\n<p>You do not need to immediately update to the latest onboarding version. We will notify you approximately 6-12 months before we sunset a version. To use any new features and meet compliance requirements, we recommend that you update to the latest version as soon as possible.<\/p>\n<h3>Legal Entity Management API<\/h3>\n<p>We regularly update the Legal Entity Management API with <a href=\"\/pt\/development-resources\/versioning#non-breaking-changes\">non-breaking changes<\/a>, so you can receive updates without needing to re-integrate with Adyen. These changes do not break existing integrations.<\/p>\n<p>The following are considered non-breaking changes:<\/p>\n<ul>\n<li>An existing data point becomes needed in order to meet the minimum requirements for allowing a certain capability, such as paying out to your user. For example, a sole proprietorship in a new supported country or for an additional requested capability.<\/li>\n<li>Adding or updating <a href=\"\/pt\/marketplaces\/kyc-verification-codes\">verification errors<\/a> since they are string values.<\/li>\n<li>Adding new features or making enhancements to the performance of Adyen's APIs.<\/li>\n<\/ul>\n<p>When a breaking change is necessary, we release this change as part of a new version of the LEM API. If there are critical security or compliance changes required, we first release this version in test environments four weeks before it is available in live environments. Adyen notifies you about these changes in your <a href=\"https:\/\/ca-test.adyen.com\/\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Customer Area<\/a>.<\/p>\n<p>Any API changes are always backward compatible, but not forwards compatible. Changes to the LEM API are described in our <a href=\"\/pt\/release-notes\/platforms-and-financial-products\">release notes<\/a>.<\/p>\n<div class=\"notices green\">\n<p>To see the difference between Legal Entity Management API versions, use the <a href=\"https:\/\/docs.adyen.com\/api-explorer\/api-diff-tool\" class=\"codeLabel external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">API Diff Tool<\/a>.<\/p>\n<\/div>\n<div class=\"accordion-shortcode adl-accordion adl-accordion--max-height-transition\" data-expand=\"true\" data-ignore=\"anchorjs-link\">\n    \n    <div class=\"adl-accordion__item\" style=\"\">\n        <div tabindex=\"0\" role=\"item\" aria-expanded=\"false\" class=\"adl-accordion__header\">\n            <i class=\"adl-accordion__toggle adl-icon-chevron-down\"><\/i>\n            <div class=\"adl-accordion__title-wrapper\" data-accordion=\"#release-schedule\">\n                                    <h4 class=\"adl-accordion__title\">Release schedule<\/h4>\n                            <\/div>\n        <\/div>\n        <div role=\"region\" class=\"adl-accordion__content\">\n            \n<p>We aim to release new stable versions of the  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/legalentity\/latest\/overview\" class=\" external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">Legal Entity Management API<\/a> and <a href=\"#hosted-onboarding\">Hosted onboarding<\/a> regularly. We recommend you <a href=\"\/pt\/development-resources\/versioning#upgrade-api\">upgrade<\/a> to the latest API version as soon as possible. Although older versions can still be used, they do not receive any additional updates.<\/p>\n<p>Before we release a new stable version of the LEM API, we offer a preview API-only release candidate version. The release candidate version is subject to change based on feedback received from pilot merchants.<\/p>\n<p>The release candidate API version provides early access to new features and improvements planned for the latest stable version. To get access to a release candidate version, contact your Adyen account manager.<\/p>\n\n        <\/div>\n    <\/div>\n<\/div>\n\n<div class=\"accordion-shortcode adl-accordion adl-accordion--max-height-transition\" data-expand=\"true\" data-ignore=\"anchorjs-link\">\n    \n    <div class=\"adl-accordion__item\" style=\"\">\n        <div tabindex=\"0\" role=\"item\" aria-expanded=\"false\" class=\"adl-accordion__header\">\n            <i class=\"adl-accordion__toggle adl-icon-chevron-down\"><\/i>\n            <div class=\"adl-accordion__title-wrapper\" data-accordion=\"#sunsetting-lem-api-versions-and-updating-to-new-versions\">\n                                    <h4 class=\"adl-accordion__title\">Sunsetting LEM API versions and updating to new versions<\/h4>\n                            <\/div>\n        <\/div>\n        <div role=\"region\" class=\"adl-accordion__content\">\n            \n<p>As part of our API lifecycle management, we may need to sunset older versions of the  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/legalentity\/latest\/overview\" class=\" external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">Legal Entity Management API<\/a>. After the specified sunset date, you can no longer use that version of the API.<\/p>\n<p>If you use API-only onboarding, you need to update to the latest API version before the sunset date of the version that you are using.<\/p>\n<p>If you only use hosted onboarding, you still need to update to the latest API version before the sunset date. This is so that your hosted onboarding page remains up-to-date. See <a href=\"#update-v3\">here<\/a> for more information about how to update to onboarding v3, the latest stable onboarding version.<\/p>\n\n        <\/div>\n    <\/div>\n<\/div>\n\n<h2 id=\"update-version\">Update your onboarding version<\/h2>\n<p>To update your onboarding version to the latest version:<\/p>\n<ol>\n<li>Reach out to your Adyen contact to discuss your update and timelines.<\/li>\n<li>Update your server integration to v4 of the  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/legalentity\/latest\/overview\" class=\" external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">Legal Entity Management API<\/a>.<\/li>\n<li>Review and implement any new features.<\/li>\n<li><a href=\"#test-onboarding\">Test your integration<\/a>.<\/li>\n<li>Go live with the new onboarding version.<\/li>\n<\/ol>\n<h3>Update from v2 to v4<\/h3>\n<p>The following table explains some key differences between onboarding v2 and v4 for specific features. For more information, see the dedicated <a href=\"\/pt\/marketplaces\/onboard-users\/onboarding-versions\/onboarding-v4\">v4 overview page<\/a> and the <a href=\"https:\/\/docs.adyen.com\/api-explorer\/api-diff-tool\" class=\"codeLabel external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">API Diff Tool<\/a>.<\/p>\n<div class=\"sticky-table-container\">\n    \n<\/div>\n\n<table>\n<thead>\n<tr>\n<th>Features<\/th>\n<th>User onboarded in older version<\/th>\n<th>New user onboarded in latest version<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td><a href=\"\/pt\/marketplaces\/verification-overview?tab=adyen_requires_data_review_4#verification-deadlines\">Verification deadlines<\/a><\/td>\n<td>Available after the onboarding version is updated. Capabilities that were invalid in the older version do not automatically receive verification deadlines.<\/td>\n<td>Available<\/td>\n<td><\/td>\n<\/tr>\n<tr>\n<td><a href=\"\/pt\/marketplaces\/onboard-users\/terms-of-service\/\">Acceptance of Adyen's Terms of Service<\/a><\/td>\n<td>Acceptance by the user is backfilled. If new capabilities are requested, the user must sign additional ToS documents.<\/td>\n<td>Automatically required when user is onboarded.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p>Depending on your <a href=\"\/pt\/marketplaces\/onboard-users\">type of onboarding<\/a>, you need to perform the following actions. Note that after updating your onboarding version, verification checks are not immediately triggered for your users. New verification checks are only triggered when the user <a href=\"\/pt\/marketplaces\/verification-overview\/#when-users-change-their-data\">updates their data<\/a> or has a <a href=\"\/pt\/marketplaces\/verification-overview\/#when-adyen-requires-data-reviews\">required data review<\/a>.<\/p>\n\n<div id=\"tabnOVHJ\">\n    <div data-component-wrapper=\"tabs\">\n        <tabs\n                        :items=\"[{&quot;title&quot;:&quot;Hosted onboarding&quot;,&quot;content&quot;:&quot;\\n&lt;p&gt;Hosted onboarding is built on top of our Legal Entity Management (LEM) API. Therefore, if you are using hosted onboarding, it continues to use LEM v2 until you update your integration. After the update, it automatically uses LEM v4.&lt;\\\/p&gt;\\n&lt;p&gt;To support onboarding v4, you need to implement the following backend changes to your systems:&lt;\\\/p&gt;\\n&lt;ul&gt;\\n&lt;li&gt;\\n&lt;p&gt;Implement logic to notify your users when they have a &lt;a href=\\&quot;\\\/pt\\\/marketplaces\\\/verification-overview\\\/#when-adyen-requires-data-reviews\\&quot;&gt;required data review&lt;\\\/a&gt;. The user can confirm or update their information in the hosted onboarding page.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Implement logic to interpret and enforce &lt;a href=\\&quot;\\\/pt\\\/marketplaces\\\/verification-overview\\\/#verification-deadlines\\&quot;&gt;verification deadlines&lt;\\\/a&gt;.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Review the &lt;a href=\\&quot;\\\/pt\\\/marketplaces\\\/onboard-users\\\/onboarding-versions\\\/onboarding-v4#countries-regions\\&quot;&gt;new compliance requirements&lt;\\\/a&gt; for specific countries\\\/regions.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Review the new structure for verification errors. In earlier onboarding versions, each capability requested for the legal entity had any verification errors shown within the capability array. Verification errors are now shown with all affected capabilities as an array underneath. You can also use the new  &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/legalentity\\\/latest\\\/post\\\/legalEntities\\\/(id)\\\/checkVerificationErrors\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;\\\/checkVerificationErrors&lt;\\\/a&gt; endpoint to see only the verification errors for a legal entity.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Review the new webhook structure for verification statuses. The capability &lt;strong&gt;sendToTransferInstrument&lt;\\\/strong&gt; is now validated at both the transfer instrument resource and associated legal entity level. This means that transfers are possible to a verified transfer instrument independently of the verification status of other transfer instruments that the legal entity has.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Review the &lt;a href=\\&quot;\\\/pt\\\/marketplaces\\\/onboard-users\\\/onboarding-steps\\&quot;&gt;required data points&lt;\\\/a&gt;.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Review the &lt;a href=\\&quot;\\\/pt\\\/marketplaces\\\/onboard-users\\\/onboarding-versions\\\/onboarding-v4\\\/#validations\\&quot;&gt;new validations for name and address fields&lt;\\\/a&gt;.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Align with the new API structure when creating business lines. The  &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/legalentity\\\/latest\\\/post\\\/businessLines#request-capability\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;capability&lt;\\\/a&gt; field has been replaced by the  &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/legalentity\\\/latest\\\/post\\\/businessLines#request-service\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;service&lt;\\\/a&gt; field. The  &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/legalentity\\\/latest\\\/post\\\/businessLines#request-capability\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;capability&lt;\\\/a&gt; field is now deprecated. The possible values for  &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/legalentity\\\/latest\\\/post\\\/businessLines#request-service\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;service&lt;\\\/a&gt; are:&lt;\\\/p&gt;\\n&lt;ul&gt;\\n&lt;li&gt;&lt;strong&gt;paymentProcessing&lt;\\\/strong&gt;: corresponds to capability &lt;strong&gt;receivePayments&lt;\\\/strong&gt;&lt;\\\/li&gt;\\n&lt;li&gt;&lt;strong&gt;banking&lt;\\\/strong&gt; corresponds to capability &lt;strong&gt;issueBankAccount&lt;\\\/strong&gt;&lt;\\\/li&gt;\\n&lt;li&gt;&lt;strong&gt;issuing&lt;\\\/strong&gt; corresponds to capability &lt;strong&gt;issueCard&lt;\\\/strong&gt;&lt;\\\/li&gt;\\n&lt;\\\/ul&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;When creating business lines, you must provide the &lt;a href=\\&quot;\\\/pt\\\/marketplaces\\\/onboard-users\\\/onboarding-versions\\\/onboarding-v4\\\/#source-funds\\&quot;&gt;source of funds&lt;\\\/a&gt; for both card issuing and business accounts.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;\\\/ul&gt;\\n&quot;,&quot;altTitle&quot;:null,&quot;oldTabId&quot;:&quot;hosted_onboarding_0_1&quot;,&quot;relation&quot;:&quot;&quot;},{&quot;title&quot;:&quot;API-only onboarding&quot;,&quot;content&quot;:&quot;\\n&lt;p&gt;To support onboarding v4, you need to implement the following backend changes to your systems.&lt;\\\/p&gt;\\n&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Implement logic to notify your users when they have a &lt;a href=\\&quot;\\\/pt\\\/marketplaces\\\/verification-overview\\\/#when-adyen-requires-data-reviews\\&quot;&gt;required data review&lt;\\\/a&gt;.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Implement logic to interpret and enforce &lt;a href=\\&quot;\\\/pt\\\/marketplaces\\\/verification-overview\\\/#verification-deadlines\\&quot;&gt;verification deadlines&lt;\\\/a&gt;.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Review the &lt;a href=\\&quot;\\\/pt\\\/marketplaces\\\/onboard-users\\\/onboarding-versions\\\/onboarding-v4#countries-regions\\&quot;&gt;new compliance requirements&lt;\\\/a&gt; for specific countries\\\/regions.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Review the new structure for verification errors. In earlier onboarding versions, each capability requested for the legal entity had any verification errors shown within the capability array. Verification errors are now shown with all affected capabilities as an array underneath. You can also use the new  &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/legalentity\\\/latest\\\/post\\\/legalEntities\\\/(id)\\\/checkVerificationErrors\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;\\\/checkVerificationErrors&lt;\\\/a&gt; endpoint to see only the verification errors for a legal entity.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Review the new webhook structure for verification statuses. The capability &lt;strong&gt;sendToTransferInstrument&lt;\\\/strong&gt; is now validated at both the transfer instrument resource and associated legal entity level. The capability status of the user is only visible at the legal entity level until they update their data or they have a required data review.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Review the &lt;a href=\\&quot;\\\/pt\\\/marketplaces\\\/onboard-users\\\/onboarding-steps\\&quot;&gt;required data points&lt;\\\/a&gt;.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Review the new API structure when creating  &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/legalentity\\\/latest\\\/post\\\/transferInstruments\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;\\\/transferInstruments&lt;\\\/a&gt;. The new  &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/legalentity\\\/latest\\\/post\\\/transferInstruments#request-type\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;type&lt;\\\/a&gt; field specifies whether the bank account is an IBAN or local account. The required information is then based on the type.&lt;\\\/p&gt;\\n&lt;ul&gt;\\n&lt;li&gt;To integrate more quickly, we recommend using our &lt;a href=\\&quot;\\\/pt\\\/marketplaces\\\/onboard-users\\\/components\\\/transfer-instrument\\&quot;&gt;transfer instrument components&lt;\\\/a&gt;. The components reduce the number of API requests needed to create transfer instrument resources and are always updated to the latest onboarding API version. Additionally, these components enable your users to verify their bank accounts instantly when adding or updating their bank account details.&lt;\\\/li&gt;\\n&lt;\\\/ul&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Review the &lt;a href=\\&quot;\\\/pt\\\/marketplaces\\\/onboard-users\\\/onboarding-versions\\\/onboarding-v4\\\/#validations\\&quot;&gt;new validations for name and address fields&lt;\\\/a&gt;.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Align with the new API structure when creating business lines. The  &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/legalentity\\\/latest\\\/post\\\/businessLines#request-capability\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;capability&lt;\\\/a&gt; field has been replaced by the  &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/legalentity\\\/latest\\\/post\\\/businessLines#request-service\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;service&lt;\\\/a&gt; field. The  &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/legalentity\\\/latest\\\/post\\\/businessLines#request-capability\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;capability&lt;\\\/a&gt; field is now deprecated. The possible values for  &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/legalentity\\\/latest\\\/post\\\/businessLines#request-service\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;service&lt;\\\/a&gt; are:&lt;\\\/p&gt;\\n&lt;ul&gt;\\n&lt;li&gt;&lt;strong&gt;paymentProcessing&lt;\\\/strong&gt;: corresponds to capability &lt;strong&gt;receivePayments&lt;\\\/strong&gt;&lt;\\\/li&gt;\\n&lt;li&gt;&lt;strong&gt;banking&lt;\\\/strong&gt; corresponds to capability &lt;strong&gt;issueBankAccount&lt;\\\/strong&gt;&lt;\\\/li&gt;\\n&lt;li&gt;&lt;strong&gt;issuing&lt;\\\/strong&gt; corresponds to capability &lt;strong&gt;issueCard&lt;\\\/strong&gt;&lt;\\\/li&gt;\\n&lt;\\\/ul&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;When creating business lines, you must provide the &lt;a href=\\&quot;\\\/pt\\\/marketplaces\\\/onboard-users\\\/onboarding-versions\\\/onboarding-v4\\\/#source-funds\\&quot;&gt;source of funds&lt;\\\/a&gt; for both card issuing and business accounts.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;\\\/ul&gt;\\n&quot;,&quot;altTitle&quot;:null,&quot;oldTabId&quot;:&quot;api-only_onboarding_2_3&quot;,&quot;relation&quot;:&quot;&quot;}]\"\n            :should-update-when-url-changes='false'>\n        <\/tabs>\n    <\/div>\n<\/div>\n\n<h3 id=\"test-onboarding\">Test your integration<\/h3>\n<p>When you are ready to test the new onboarding version, reach out to your Adyen contact to ensure that all new features are enabled in your test environment. We strongly recommend that you perform integration tests for all major features and <a href=\"\/pt\/marketplaces\/test-verification-errors\">check your error handling<\/a> if the verification process is unsuccessful.<\/p>\n<h2 id=\"see-also\">See also<\/h2>\n<div class=\"see-also-links output-inline\" id=\"see-also\">\n<ul><li><a href=\"\/release-notes\/platforms-and-financial-products\/\"\n                        target=\"_self\"\n                        >\n                    Release notes\n                <\/a><\/li><\/ul><\/div>\n","url":"https:\/\/docs.adyen.com\/pt\/marketplaces\/onboard-users\/onboarding-versions","articleFields":{"description":"Learn how you can keep your integration up-to-date with the latest onboarding version.","feedback_component":true,"filters_component":false,"parameters":{"directoryPath":"\/marketplaces","model":"marketplace"},"decision_tree":"[]","page_id":"55051eb9-ced9-4fda-adb7-4899f590755c","last_edit_on":"10-02-2025 10:35"},"algolia":{"url":"https:\/\/docs.adyen.com\/pt\/marketplaces\/onboard-users\/onboarding-versions","title":"Onboarding versions","content":"This page explains onboarding versioning and what you need to do in order to update to the latest onboarding version. We recommend that you update to the latest version as soon as possible to take advantage of new features and meet compliance requirements. The latest stable onboarding version is v4. For more information about onboarding v4, see the v4 overview page.\nOnboarding versioning\nAn onboarding version includes any breaking changes related to:\n\nLegal Entity Management API\nHosted onboarding\nKnow your customer (KYC) verification checks\n\nIf a breaking change needs to be made in any of these three areas, we introduce this as part of a new onboarding version. However, an onboarding version does not necessarily include changes in all three areas.\nYou do not need to immediately update to the latest onboarding version. We will notify you approximately 6-12 months before we sunset a version. To use any new features and meet compliance requirements, we recommend that you update to the latest version as soon as possible.\nLegal Entity Management API\nWe regularly update the Legal Entity Management API with non-breaking changes, so you can receive updates without needing to re-integrate with Adyen. These changes do not break existing integrations.\nThe following are considered non-breaking changes:\n\nAn existing data point becomes needed in order to meet the minimum requirements for allowing a certain capability, such as paying out to your user. For example, a sole proprietorship in a new supported country or for an additional requested capability.\nAdding or updating verification errors since they are string values.\nAdding new features or making enhancements to the performance of Adyen's APIs.\n\nWhen a breaking change is necessary, we release this change as part of a new version of the LEM API. If there are critical security or compliance changes required, we first release this version in test environments four weeks before it is available in live environments. Adyen notifies you about these changes in your Customer Area.\nAny API changes are always backward compatible, but not forwards compatible. Changes to the LEM API are described in our release notes.\n\nTo see the difference between Legal Entity Management API versions, use the API Diff Tool.\n\n\n    \n    \n        \n            \n            \n                                    Release schedule\n                            \n        \n        \n            \nWe aim to release new stable versions of the  Legal Entity Management API and Hosted onboarding regularly. We recommend you upgrade to the latest API version as soon as possible. Although older versions can still be used, they do not receive any additional updates.\nBefore we release a new stable version of the LEM API, we offer a preview API-only release candidate version. The release candidate version is subject to change based on feedback received from pilot merchants.\nThe release candidate API version provides early access to new features and improvements planned for the latest stable version. To get access to a release candidate version, contact your Adyen account manager.\n\n        \n    \n\n\n\n    \n    \n        \n            \n            \n                                    Sunsetting LEM API versions and updating to new versions\n                            \n        \n        \n            \nAs part of our API lifecycle management, we may need to sunset older versions of the  Legal Entity Management API. After the specified sunset date, you can no longer use that version of the API.\nIf you use API-only onboarding, you need to update to the latest API version before the sunset date of the version that you are using.\nIf you only use hosted onboarding, you still need to update to the latest API version before the sunset date. This is so that your hosted onboarding page remains up-to-date. See here for more information about how to update to onboarding v3, the latest stable onboarding version.\n\n        \n    \n\n\nUpdate your onboarding version\nTo update your onboarding version to the latest version:\n\nReach out to your Adyen contact to discuss your update and timelines.\nUpdate your server integration to v4 of the  Legal Entity Management API.\nReview and implement any new features.\nTest your integration.\nGo live with the new onboarding version.\n\nUpdate from v2 to v4\nThe following table explains some key differences between onboarding v2 and v4 for specific features. For more information, see the dedicated v4 overview page and the API Diff Tool.\n\n    \n\n\n\n\n\nFeatures\nUser onboarded in older version\nNew user onboarded in latest version\n\n\n\n\nVerification deadlines\nAvailable after the onboarding version is updated. Capabilities that were invalid in the older version do not automatically receive verification deadlines.\nAvailable\n\n\n\nAcceptance of Adyen's Terms of Service\nAcceptance by the user is backfilled. If new capabilities are requested, the user must sign additional ToS documents.\nAutomatically required when user is onboarded.\n\n\n\nDepending on your type of onboarding, you need to perform the following actions. Note that after updating your onboarding version, verification checks are not immediately triggered for your users. New verification checks are only triggered when the user updates their data or has a required data review.\n\n\n    \n        \n        \n    \n\n\nTest your integration\nWhen you are ready to test the new onboarding version, reach out to your Adyen contact to ensure that all new features are enabled in your test environment. We strongly recommend that you perform integration tests for all major features and check your error handling if the verification process is unsuccessful.\nSee also\n\n\n                    Release notes\n                \n","type":"page","locale":"pt","boost":17,"hierarchy":{"lvl0":"Home","lvl1":"Marketplaces","lvl2":"Onboard and verify users","lvl3":"Onboarding versions"},"hierarchy_url":{"lvl0":"https:\/\/docs.adyen.com\/pt","lvl1":"https:\/\/docs.adyen.com\/pt\/marketplaces","lvl2":"https:\/\/docs.adyen.com\/pt\/marketplaces\/onboard-users","lvl3":"\/pt\/marketplaces\/onboard-users\/onboarding-versions"},"levels":4,"category":"Marketplaces","category_color":"green","tags":["Onboarding","versions"]}}