Migrating to OneSDK
If you're currently using Smart UI with your FrankieOne integration, use the following information to migrate to OneSDK:
Smart UI + Onfido
If you have been using Smart UI + Onfido, there are two ways to migrate to OneSDK:
- Using Biometrics-first flow
- Smart UI + IDV flow
1- Biometrics-first
We recommend using Biometrics-first flow to have a faster and better onboarding experience. In OneSDK, you can switch to either Onfido Motion or Incode to run OCR and Biometrics. Please visit OneSDK Getting Started to learn more about OneSDK and how to work with it. Once you get started, to integrate with different IDV vendors, navigate to the following pages:
To have a full E2E experience and optimise your UX, OneSDK Modular Forms will also provide out-of-the-box screens which you can embed at any point of your onboarding. Learn more about Modular Forms - Biometrics/OCR flow.
2- Smart UI + IDV
If you want to keep the Smart UI part as-is to have a smoother transition, it is also available in the OneSDK Form module and it accepts the same configuration as before, with some minor changes. If you've been using SmartUI previously, you can conveniently migrate to the Form module in OneSDK using your previous configuration. Learn more about OneSDK Forms and How to run Smart UI in OneSDK.
The IDV component is handled by a separate module in OneSDK, so for this part of your flow, you just need to use the OneSDK IDV module using Onfido Motion or Incode. Learn more about IDV module in the following pages:
Onfido
Please note, only Onfido Motion is available in OneSDK (with a fallback to Onfido Video/Selfie). We're not using Onfido Video/Selfie Variants by default anymore.
In OneSDK, we aim to offer best of breed solutions to enhance your product and prevent fraud. Onfido Motion and Incode are more robust against AI generated attacks and also faster.
If you have been using Onfido Video/Selfie previously, we strongly recommend to switch to Onfido Motion or Incode to enhnce your product.
Config changes
If you want to use Smart UI within OneSDK, please consider the following changes to the configuration parameters:
| Item | Note |
|---|---|
ffToken | You don't need to pass ffToken anymore as Smart UI is one of the OneSDK modules. You only need to initialise OneSDK with a session token. To learn more about how to initialise OneSDK, please visit OneSDK Getting Started. |
applicantReference | When generating a session token to initialise OneSDK, you can still use an existing reference. Learn more about pre-filling applicant data. |
frankieBackendUrl | No longer applicable |
idScanVerification | This is no longer applicable. SmartUI within OneSDK is only the manual interface. The IDV component is handled by a separate module in OneSDK as described above. |
enableDeviceCharacteristics | Device fraud detection is no longer applicable since this will be handled by a separate OneSDK component. |
To learn more about how to configure Smart UI in OneSDK, navigate to Smart UI in OneSDK and Form configuration.
Smart UI Only
If you have been using Smart UI only, without IDV, there are two ways to migrate to OneSDK:
- Smart UI in OneSDK
- New Manual Forms in OneSDK (coming soon)
1- Smart UI in OneSDK
As stated above, Smart UI is already available in OneSDK Form module and it accepts the same configuration as before, with some minor changes. Learn more about OneSDK Forms and How to run Smart UI in OneSDK.
Updated about 20 hours ago