DeviceConnect: Web

The DeviceConnect Web SDK enables the collection of anonymized, non-PII data from user devices, ensuring compliance with privacy policies by obtaining explicit user consent before initiating data sync processes.

Requirements

Device Connect Web SDK works on Google Chrome, Safari, Opera and other popular browsers.

Adding Dependency

Add the SDK to the application to package.json.

Using yarn:

yarn add web-risk-sdk

or using npm:

npm install --save web-risk-sdk

NOTE

Following will be shared by FinBox team at the time of integration:

• CLIENT_API_KEY

Create User

To create a user, call the createUser method with the following arguments:

• Client API Key
• Customer ID

IMPORTANT

• CUSTOMER_ID Must be alphanumeric (no special characters).
• Should not exceed 64 characters.
• Must not be null or an empty string "".

The response to this method (success or failure) can be captured using the callbacks.

• Javascript

FinBox.createUser("CLIENT_API_KEY", "CUSTOMER_ID", (token) => {
    // Authentication is success
    console.log("Token", token)
}, (error) => {
    // Authentication failed
    console.log("Error", error)
})

You can read about the errors in the Error Codes section.

Start Periodic Sync

The startPeriodicSync method should be invoked only after receiving a successful response from the createUser method callback. This method initiates background syncing for all data sources based on the permissions granted by the user. Data is synced at regular intervals in the background, ensuring continuous and seamless data collection.

• Javascript

const finbox = new FinBox()
finbox.startPeriodicSync()

RECOMMENDATION

To handle cross-login scenarios:

When a user logs back into the app with fresh credentials:

• Call the createUser method to register the new user.
• Follow it by startPeriodicSync to resume data syncing for the new user. Even though the SDK automatically adapts to a new user, this approach minimizes potential delays in syncing during the first session

Cancel Periodic Sync

Make sure to cancel data synchronization tasks when the user logs out of the app by using the stopPeriodicSync method. This ensures that no background sync operations continue unnecessarily, maintaining data security.

• Javascript

finbox.stopPeriodicSync()

Handle Sync Frequency

By default sync frequency is set to 8 hours, you can modify it by passing preferred time in seconds as an argument to setSyncFrequency method once the user is created.

• Javascript

finbox.setSyncFrequency(12 * 60 * 60)

Reset User Data

If you need to clear a user's data stored on the device and initiate a fresh data sync, use the resetData method. This ensures that all previous data is removed, and syncing starts from scratch.

• Javascript

FinBox.resetData()

Forget User

If a user requests to be forgotten, use the forgetUser method. This will delete all user details from our system, ensuring this meets digital guidelines for right to be forgotten.

• Javascript

FinBox.forgetUser()