Migrating from v3 to v4

Migrate to version 4 of Smart UI in order to benefit from the following:

• Faster loading due to a much improved reduced bundle size.
• Support for digital driver’s licenses (opt-in).
• Improved error handling and reporting.
• Support for uploading supporting documents.

Version 4 also updates the end-user experience for users in Indonesia:

• When inputting an Indonesian document, users will be prompted to add their name, they will be provided with a second name screen where they can review their input.

Prerequisites

These instructions assume that you have already integrated with version 3 of Smart UI. If this isn’t the case, explore the migration guides for other versions.

Step 1: Update the <script> element

Update the <script> element to reference the latest version of Smart UI.

If using the minified bundle, the <script> element should look like:

1
<script src="https://assets.frankiefinancial.io/onboarding/v4/ff-onboarding-widget.umd.min.js"></script>

If you were using the non-minified bundle, your <script> element should look like:

1
<script src="https://assets.frankiefinancial.io/onboarding/v4/ff-onboarding-widget.umd.js"></script>

Step 2: Update the Content Security Policy

If your website uses a Content Security Policy (CSP) you will need to update it to allow img-src content from assets.frankiefinancial.io.

Step 3 (Optional): Allow digital driver’s licenses

Update the configuration object that’s passed to the initialiseOnboardingWidget() method to opt-in to allowing digital driver’s licenses.

If your configuration object doesn’t contain the documentTypes key or you don’t wish to allow digital driver’s licenses then you can safely ignore this step.

Replace the string value "DRIVERS_LICENCE" with the following object:

1
{
2
  "type": "DRIVERS_LICENCE",
3
  "digitalLicense": true
4
}

1
frankieFinancial.initialiseOnboardingWidget({
2
  config: {
3
    documentTypes: [
4
      "DRIVERS_LICENCE",
5
      // Other document types
6
    ],
7
    // Other configuration parameters
8
  },
9
  // Other initialisation parameters
10
});

1
frankieFinancial.initialiseOnboardingWidget({
2
  config: {
3
    documentTypes: [
4
      {
5
        "type": "DRIVERS_LICENCE",
6
        "digitalLicense": true
7
      },
8
      // Other document types
9
    ],
10
    // Other configuration parameters
11
  },
12
  // Other initialisation parameters
13
});

Next steps

Version 4 can allow your users to upload supporting documents. To make use of this feature, we recommend speaking to our team first.