Migrate from WebSDK 1.0 to WebSDK 2.0
Achieve better performance by using WebSDK 2.0.
The WebSDK 2.0 represents a complete rewrite of the entire SDK, incorporating new technologies and introducing changes that could not be implemented within the framework of the old codebase. While we have strived to maintain maximum compatibility with the old SDK to facilitate a smooth transition between versions, some actions on your part are still required.
Attention
Be aware that after September 1, 2024, the WebSDK 1.0 version will no longer be supported, and only security bugs will be fixed.
Migration steps
- Ensure you are using the latest version of our library.
- This should be version 2.3.1 or higher.
- This step does not upgrade your SDK to WebSDK 2.0, meaning you can update the library version and continue using the old SDK while experimenting with the new one.
- If you are using any SDK events, verify that you are using compatible versions.
stepComplete
→onStepCompleted
applicantStatus
→onApplicantStatusChanged
- CSS customizations are no longer supported. Now, you can customize the SDK via the customization editor in our Dashboard.
- CSS customizations will continue to work in the old SDK.
- Many CSS customizations can be automatically converted to the new format. To do this, you can create a new customization and select Import styles → Import styles from WebSDK 1.0 in the top-right corner.
- You can also import website styles through the Import styles menu.
- Once you have completed the previous steps, you can enable the new SDK for a specific level. To do this, go to the level settings and select Enable WebSDK 2.0 for this level.
- If you use unilinks, you need to obtain a new link on the level page.
The following are not yet supported in the WebSDK 2.0:
- Selfie with a document checks.
- Videoident.
Gradual migration
If you are already using the WebSDK, you likely want to migrate gradually, level by level. This can easily be achieved as the activation of the WebSDK 2.0 is done through a toggle in the settings of each level. Thus, you can complete the first three steps from the section above and then gradually switch your levels to the new SDK.
Updated about 2 months ago