Web SDK Setup

This page sets out step-by-step instructions for setting up the Web SDK.

WebView manual

Tip

For an integration option that provides NFC support and a better mobile experience than a WebView, we recommend using the App Drop-in.

To integrate the Web SDK via WebView, follow these steps:

1. Make a Create SDK session request to create an 8-digit, alphanumerical validationCode for the Web SDK session, e.g. A1B2C3D4:

📖 Create Web SDK session

2. Pass the validationCode in the URL to the embedded browser:

Example URL:

https://sandbox.v.fourthline.com/v1/?code=A1B2C3D4

Success page

To redirect the client to your Success page when they successfully complete the workflow, add a redirect parameter to the URL:

Example Success page URL:

https://sandbox.v.fourthline.com/v1/?code=A1B2C3D4&redirect=https://yoursuccesspage.com

Failure page

To redirect the client to your Failure page if they do not successfully complete the workflow, add a redirectFailure parameter to the URL:

Example Failure page URL:

https://sandbox.v.fourthline.com/v1/?code=A1B2C3D4&redirectFailure=https://yourfailurepage.com

Example with Success and Failure page URLs:

https://sandbox.v.fourthline.com/v1/?code=A1B2C3D4&redirect=https://yoursuccesspage.com&redirectFailure=https://yourfailurepage.com

Localization

To set the UI language and level of formality, add the locale and formality parameters to the URL:

https://sandbox.v.fourthline.com/v1/?code=A1B2C3D4&locale=es&formality=formal

For a list of supported languages and formality level, see Localize the UI documentation.

Note
The localization settings are applied when the session is created. To change them, you must create a new SDK session to generate a new validationCode.

iOS video playback quality

To ensure video playback quality on iOS and maintain a high conversion rate for document and selfie videos, when you launch the Web SDK in WebView, in your iOS app, set the following parameter in the app to true:

More information

See the Apple Developer documentation for allowsInlineMediaPlayback.