OneSDK

Version History

v1.8.6

04 June 2025

The following changes are included in this release:

  • Sumsub as new additional IDV partner: We’ve added Sumsub as an IDV partner, to provide additional options for customers especially for cryptocurrency companies. Contact your Customer Success team member if you are interested learn more.

  • Eliminate separate calls for OCR and Biometrics: We’ve improved how we process results from Onfido. Now, a single API call handles both OCR and Biometrics, eliminating the need for separate calls. This update simplifies the process and enhances reliability, ensuring you receive accurate results more efficiently.

  • Telemetry improvements: The OCR, Biometrics, and IDV modules now emit more granular events, giving you richer insights for monitoring and troubleshooting.

v1.8.5

23 May 2025

The following changes are included in this release:

  • Enhanced Tracking: Hosted OneSDK (using iframe) will now send a notification to our event system when they receive a “window unload” message from the parent window. This helps us track when the application is being closed or navigated away from.

  • Custom Retry Pages and Outage for DVS: Introduced a feature to customize retry pages based on specific field errors during verification or front-end validation processes. This allows users to focus on correcting only the necessary fields rather than all fields. This covers Personal Information Errors and Document Errors. Display an error screen advising customers to try again later due to system unavailability (500 - timeout).

  • Handle invalid document type event: Emit appropriate event: input_required when we received invalid document type from backend.

v1.8.4

19 May 2025

The following changes are included in this release:

  • Window Unload Event Tracking We’ve added tracking to identify when users leave the biometric verification process early. This helps distinguish between system issues and user-initiated page closure. This is applicable to embedded and non iframe hosted.

v1.8.3

13 May 2025

The following change is included in this release:

  • Country filter on manual driver’s licence screen: Resolved an issue that prevented the manual driver’s licence screen from limiting the country selector to Australia. The screen now reliably displays only “Australia (AUS).”

v1.8.2

28 Apr 2025

The following changes are included in this release:

  • Date-of-birth validation fix: Eliminated the false “Enter a valid date of birth” error that appeared even when the format and value were correct.
  • Hosted OneSDK runtime error screen: Added a dedicated error screen that appears if a problem is encountered during Hosted OneSDK execution, giving users a clear recovery path.
  • Device-permission logging: Implemented an event handler that records Incode device-permission requests, helping developers diagnose camera and microphone access issues faster.
  • New Zealand passport expiry validation fix: Corrected a defect that incorrectly flagged valid NZ passport expiry dates.

v1.8.1

10 Apr 2025

The 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.

v1.8.0

07 Apr 2025

The 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.

v1.7.21

26 Mar 2025

The 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.

v1.7.20

19 Mar 2025

The 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.

v1.7.19

07 Mar 2025

The 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

v1.7.18

27 Feb 2025

The 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.

v1.7.17

24 Feb 2025

The 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.

v1.7.16

17 Feb 2025

This 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.

v1.7.15

27 Jan 2025

The 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.

v1.7.13

13 Jan 2025

The 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

v1.7.12

16 Dec 2024

The 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

v1.7.11

26 Nov 2024

  • Improvements on phone, email and device information for fraud check

v1.7.10

22 Nov 2024

The 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

v1.7.7

21 Oct 2024

Allow 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

v1.7.6

26 Sept 2024

OneSDK now emits a clear event when the Onfido modal is closed, ensuring seamless integration and improved user experience.

v1.7.5

19 Sept 2024

Added the new Hosted OneSDK flow, idv_kyc. This new flow provides a complete end-to-end flow, including IDV and KYC

v1.7.4

16 Sept 2024

We’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.

v1.7.3

03 Sept 2024

  • 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.

v1.7.2

01 Aug 2024

Onboarding Forms: New onboarding forms extracted address mapping.
Onboarding Forms: Fix issue with country address mapped to Passport issuing country

v1.7.1

15 July 2024

New Onboarding Forms: Fix Review screen input configuration

v1.7.0

27 June 2024

Introducing 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

v1.6.1-beta

30 May 2024

OneSDK 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.

v1.5.0-beta

30 April 2024

Introducing 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

v1.4.4-beta

11 April 2024

This 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.

v.1.4.3-beta

28 March 2024

This 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

v.1.3.2-beta

19 March 2024

This 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.

v.1.3.1-beta

08 March 2024

This 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.

v1.3.0-beta

05 March 2024

This 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.

v1.2.0-beta

23 January 2024

This version of the OneSDK contains the following update:
Onfido IDV flow into OneSDK (OCR + Biometrics)

v1.1.0-beta

05 December 2023

This version of the OneSDK contains the following update:
OCR with review screen
SmartUI within OneSDK

- Minor fixes and updates

v1.0.0-beta

01 November 2023

This version of the OneSDK contains the following update:
Incode for OCR and Biometrics

v0.8.6-alpha

17 October 2023

This 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.

v0.8.3-alpha

19 September 2023

This version of the OneSDK contains the following update:

Onfido for OCR and Biometrics (Motion)

v0.8.0-alpha

01 August 2023

This version of the OneSDK contains the following update:

Addition of IDV flow

v0.7.4-alpha

28 July 2023

This 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