OneSDK

Version History

Version tagDescriptionRelease date
v1.8.1The following changes are included in this release:
- Handling Consent: [Fixed] Consent from manual forms not passed correctly for a specific customer scenario
- Hosted OneSDK Success Event Format: [Fixed] Incorrect format of Hosted OneSDK idv:success event
- Phone Number Validation: [Fixed] Phone number validation failed despite correct format
- General Improvement: [Fixed] To improve security, we’ve updated our system to prevent the header from request being logged, ensuring a safer experience for users.		10 Apr 2025
v1.8.0The following changes are included in this release:
- Expanded Onfido Support: We’ve added support for Onfido version 14.* in OneSDK. To take advantage of the latest improvements, please contact our customer support team to update your configuration.
07 Apr 2025
v1.7.21The following changes are included in this release:
- Display Name Update Issue Resolved: Fixed an issue where the DisplayName was being incorrectly updated upon verification, leading to invalidation and a suspected status.
- OCR Component Failure Screen: Addressed a bug that now correctly shows a failure screen if the OCR (Object Character Recognition) component fails during processing.
26 Mar 2025
v1.7.20The following changes are included in this release:
- Order Fields in Personal Details: You can now customize the order of fields when entering personal details, enhancing the flexibility and organization of your data input.
- Fixed Loading Issue: Resolved an issue where OneSDK would fail to load if the entity had a customer reference set. This fix ensures smoother initialization and operation.
- Onfido Modal Enhancement: The Onfido modal now includes a confirmation dialog to prevent users from accidentally closing it by clicking the overlay. This enhancement prevents unintended session termination.
- OneSDK CLI Customizations: Apply customizations more effectively in IDV + Review through the OneSDK command-line interface, providing more control and efficiency in operations.		19 Mar 2025
v1.7.19The following changes are included in this release:
- Fixed Retry Screen Issue: Resolved the problem where the Retry screen persistently asked for additional ID verification. This fix ensures a smoother user experience without repetitive requests for identification.
- Improved Redirect Links: Enhanced the handling of redirect links, ensuring they are correctly applied across various flow IDs This update applies to:
- IDV + Review
- IDV + KYC
- Manual + KYC
- OCR Only		07 Mar 2025
v1.7.18The following changes are included in this release:
- Edit Button Customization: You can now customize the edit button on the review screen, enhancing the user interface according to your brand needs.
- Disabled Button Background Color: Customize the background color of disabled buttons to match your application’s aesthetic.
- Credit Header Description Customization: Tailor the credit_header_description to provide clearer guidance and context to users.
- Multiple IDs/Retry Flow Text Customization: Modify the text displayed during multiple ID submissions or retry flows to improve user understanding and reduce errors.
- Address Search Label Update: For address searches, the label now uses the value from formatted_address from the Google Search API, replacing the previous use of description from Google Predictions API. This change aims to provide more accurate and user-friendly address suggestions.
-
Fixes
- Project Build Issue: Resolved an issue where projects could not be built using the latest version of OneSDK. Ensure seamless integration and deployment with this fix.		27 Feb 2025
v1.7.17The following updates are included in this version:
- Improve OCR module to read expiry date when switching between different ID types.
- The OCR module’s events have been updated to match the order and format of the Biometrics module.
- Previously, OCR vendor loaded event is only emitted when OCR is done. Now, vendor loaded event is emitted before ready event regardless if OCR is done or not.
- Adjusted the credit header text for passed KYC checks.
- Trigger Google API requests when typing is complete. This optimization reduces the number of API calls and associated costs.

Additional configurable components:
- HTML link tags: Updated the HTML sanitization logic to allow the <a target="_blank"> tag. This allows customers to include links that open in a new tab within consent screens, enhancing user experience.
- Checkbox colors: Added the ability to customize the color of checkboxes using the .ff-checkbox CSS class and the accent-color property. This allows for greater flexibility in styling consent screens.		24 Feb 2025
v1.7.16This version of the OneSDK includes the latest enhancements and updates that we’ve made to improve your experience with our platform. It also fixes issues previously encountered.17 Feb 2025
v1.7.15The following changes have been implemented in this version:
- General improvements, including improved logic for handling entity information updates and status flagging.
- Resolved an issue where the UI was not visible in dark mode.
- Updated the messaging on the result screen for KYC check results.		27 Jan 2025
v1.7.13The following updates are included in this version:
- Enhanced OCR Review with Manual Address Input: The OCR review screen now defaults to manual address input, ensuring accurate and complete address information by requiring users to fill in individual address fields.
- Configurable OCR Field Extraction: Customers can now configure which specific fields should be pre-filled after OCR extraction, providing greater control over the data review process.
- Rate Limit Investigation for OneSDK Calls: We’ve implemented measures to investigate and potentially rate-limit critical calls within the OneSDK to ensure stability and prevent rapid successive executions.

- Additional Error Handling:
1. We’ve addressed several scenarios to provide clearer error messages and a smoother user experience, particularly when encountering issues with OCR or missing permissions.
2. Improved error Response of OCR Failures. When it fails or an invalid document is provided, system now returns a more informative error code (not a generic 500), allowing for better error handling.
- Incode version 1.75.2 support is now available. For those using embedded, you may update sdkversion to point this while customers using Hosted OneSDK will automatically fetch this version		13 Jan 2025
v1.7.12The following updates have been implemented in OneSDK:
- UI issue on Driver’s Licence button text misalignment and instruction text during selfie capture
- Missing middle name initial option for Medicare Card in eKYC form and requirement config not working
- Unable to override Labels for Personal details in Review screen
- Update Address breakdown issue
- Added ability to view and non-editable personal information (Name + DOB + Address) in the review screen and generic document screen		16 Dec 2024
v1.7.11- Improvements on phone, email and device information for fraud check26 Nov 2024
v1.7.10The following updates are included in this version:

- The review screen is skipped when an Incomplete status is received from the backend.
- Document Restrictions Not Working for Passports
- Navigation not clearing the form
- Mounting of result screen
- Document configuration for passport and driver’s licence
- Document configuration for passport and driver’s licence
- Ability to disable edit button on review screen
- Prevent OneSDK’s styling from overriding customer’s styling		22 Nov 2024
v1.7.7Allow retries after partial error before directing

Fixes
-Issue with phone number not updating individual module
-ID expiry date allows date prior to current date
-Cosmetic issue with field borders		21 Oct 2024
v1.7.6OneSDK now emits a clear event when the Onfido modal is closed, ensuring seamless integration and improved user experience.26 Sept 2024
v1.7.5Added the new Hosted OneSDK flow, idv_kyc. This new flow provides a complete end-to-end flow, including IDV and KYC19 Sept 2024
v1.7.4We’ve introduced the ability to set and remove key-value pairs (KVPs) on an entity. This enhancement enables customers to add extra information, such as a preferred name preferredName, to the entity using OneSDK.16 Sept 2024
v1.7.3- We’ve added Webpack Support to expand the compatibility of OneSDK with build tools.

Fixes
- The ID Type wasn’t being highlighted when a document was already added. This is now fixed.
- The timestamp in the Portal now correctly shows the submission time of the entity details.
- Previously, it displayed the time when OneSDK was initialized.
- Fixed a bug where a duplicate screen appeared when the back button was disabled in a single-page customer implementation.
- An error has been fixed where it was mistakenly showing up in headless OCR.
- The biometric instructions text for users has been fixed to ensure it doesn’t appear too low on the screen.		03 Sept 2024
v1.7.2Onboarding Forms: New onboarding forms extracted address mapping.
Onboarding Forms: Fix issue with country address mapped to Passport issuing country		01 Aug 2024
v1.7.1New Onboarding Forms: Fix Review screen input configuration15 July 2024
v1.7.0Introducing OneSDK Onboarding Forms

We’re thrilled to announce that in 2024 we’re launching our new OneSDK Onboarding Forms, to replace Smart UI.

OneSDK Onboarding Forms was developed through insight and feedback from valued clients, like yourself. We’re confident that it ill yield substantial benefits for both your organisation and your end-users, delivering a faster experience that isn’t only superior but also more cost-effective, and enables:

Better outcomes

- Improved Pass Rates (5-10%+ uplift)

- 2X Faster Onboarding with Biometrics-first

- Capability to conduct A/B testing of screens

- OneSDK Analytics to track user behaviourMore flexibility

- Modular forms for easy UX optimisation, facilitating rapid deployment of new designs in less than a day

- Availability of our Hosted OneSDK, managed by FrankieOne, facilitating seamless improvements and patches directly to you without involving your engineers

- Future access to our Business Onboarding Forms		27 June 2024
v1.6.1-betaOneSDK Enhancements
Updates:
Onfido: You can now limit the country and document type in the OCR header.
Onfido: Custom UI is now exposed for easier customization.
Individual Module: The entityProfile is now accessible for use.

Fixed
Mock Mode: Issues with exit/error functionality have been resolved.

Hosted OneSDK Updates
FIxed
Loading Spinner: The problem with the loading spinner not working has been fixed.		30 May 2024
v1.5.0-betaIntroducing OneSDK Onboarding Forms
We’re thrilled to announce that in 2024 we’re launching our new OneSDK Onboarding Forms, to replace Smart UI.

OneSDK Onboarding Forms was developed through insight and feedback from valued clients, like yourself. We’re confident that it will yield substantial benefits for both your organisation and your end-users, delivering a faster experience that isn’t only superior but also more cost-effective, and enables:

Better outcomes

- Improved Pass Rates (5-10%+ uplift)

- 2X Faster Onboarding with Biometrics-first

- Capability to conduct A/B testing of screens

- OneSDK Analytics to track user behaviour
More flexibility

- Modular forms for easy UX optimisation, facilitating rapid deployment of new designs in less than a day

- Availability of our Hosted OneSDK, managed by FrankieOne, facilitating seamless improvements and patches directly to you without involving your engineers

- Future access to our Business Onboarding Forms		30 April 2024
v1.4.4-betaThis version of the OneSDK contains the following updates:

- For Incode, we’ve added the ability to force a specific document type for OCR processing.
- Handling of CSS within the OneSDK has also been improved.
- We’ve introduced support for DigitalID in OCRLabs
- Our team also resolved issues related to the NPM package.		11 April 2024
v.1.4.3-betaThis version of the OneSDK contains the following updates:

- Added the full Smart UI configuration in the Form component in OneSDK.
- Additional changes to implement Smart UI into OneSDK		28 March 2024
v.1.3.2-betaThis version of the OneSDK contains the following update:
A hotfix was implemented to address an issue related to capturing driver’s license information using Incode SDK 1.66.0.
To address this issue, the default version was reverted to 1.59.0, and dynamic version selection in the recipe now permits using an alternative version.		19 March 2024
v.1.3.1-betaThis version of the OneSDK contains the following update:
A hotfix was applied to resolve an issue where iOS users encounter an error related to screen orientation.		08 March 2024
v1.3.0-betaThis version of the OneSDK contains the following update:
To align with Incode’s new policy, we’ve enabled the option to re-use the token from the IDV service.		05 March 2024
v1.2.0-betaThis version of the OneSDK contains the following update:
Onfido IDV flow into OneSDK (OCR + Biometrics)		23 January 2024
v1.1.0-betaThis version of the OneSDK contains the following update:
OCR with review screen
SmartUI within OneSDK

- Minor fixes and updates		05 December 2023
v1.0.0-betaThis version of the OneSDK contains the following update:
Incode for OCR and Biometrics		01 November 2023
v0.8.6-alphaThis version of the OneSDK contains the following update:
Hotfix for Onfido Motion
A fix was implemented to prevent the issue where the user isn’t able to proceed to OCR flow due to an infinite loop.		17 October 2023
v0.8.3-alphaThis version of the OneSDK contains the following update:

Onfido for OCR and Biometrics (Motion)		19 September 2023
v0.8.0-alphaThis version of the OneSDK contains the following update:

Addition of IDV flow		01 August 2023
v0.7.4-alphaThis version of the OneSDK contains the following features:

Capture details from an individual
Use the IDV component to capture and verify the details of an individual

Document OCR flow
The OCR component provided by OneSDK to extract document details from a document images supplied by the user

Biometrics (selfie and liveliness)
Leverage the Biometrics component or the OCR component via the OneSDK.

Device characteristics and behavioral biometrics Evaluate potential fraud indicators from the characteristics of their device as well as al their form-filling behavior using OneSDK

Support Federated Identity
Use OneSDK’s Federation component to import data from various Identity Providers (IdPs) that support OpenID Connect or OAuth2.

Additional features help developers build and test the OneSDK:

Test mode
Use mock data during development to accelerate integration by enabling your frontend and backend teams to work parallel

Headless UI
Integrate seamlessly into your existing design system to match yhour application’s look and feel

Install via CDN or npm
Choose how to integrate into your codebase.

RX.JSObservable support
Integrate into popular frontend frameworks such as Vue, Angular, or React with support for RXKS.Observable		28 July 2023