Web SDK Setup

Integrations guide

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

WebView manual

Tip
For an integration option with NFC support and a better mobile experience than 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:
  1. 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 don't 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

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:

ParameterDescription
allowsInlineMediaPlaybackA Boolean value that indicates whether HTML5 videos play inline or use the native full-screen controller.
Set to true.

More information
See Apple Developer Documentation – allowsInlineMediaPlayback.
Success
Success
You have configured and set up your Web SDK!
To integrate your solutions, see the Integration Guides section.

Top of page