Web SDK

Integrations guide

Fourthline's Web SDK smoothly redirects clients from your website to workflows in their mobile browser, hosted by Fourthline on a secure, private subdomain. It takes care of all interaction with the client, collects and uploads the relevant data (e.g. ID document, selfie, geolocation) to Fourthline for case processing. You never handle sensitive personal data.

The SDK leverages our responsive, best-practice UI, and you can customize the appearance to match the look and feel of your brand.

Supported products

The SDK supports the following products:

How it works

The flow is as follows:

Web SDK flow

Web SDK flow


Redirect flow

The redirect flow sends the client from your website to the workflow. This functionality is typically hosted by you and embedded in your website.

There are 2 redirect options:

Redirect optionDescription
QR codeThe client scans a QR code with their mobile device.
SMSThe client receives an SMS containing the workflow URL.
• The client enters their (valid) mobile phone number and clicks or taps Send SMS.
• While awaiting the SMS, the client can check their mobile phone number is correct. If the countdown reaches zero, they can click or tap Try again to go back and re-enter the phone number.
• If the client doesn't receive the SMS, they can re-request it a maximum of 3 times.

The QR code and SMS are unique for each SDK session.

QR code redirect

QR code redirect

SMS link redirect

SMS link redirect

Desktop browser

If the client starts on your website in their desktop browser, initialize the Web SDK, display the redirect options, and redirect the client to the workflow URL in their mobile browser.

Mobile browser

If the client starts on your website in their mobile browser, either:

  • You display the redirect options, and then redirect them to the workflow URL on your subdomain.
  • Or, if the SDK detects the client's mobile device, instead of displaying the redirect options, it displays a Continue to mobile device screen. This creates a better user experience.
Continue to mobile device screen

Continue to mobile device screen

Product flow

The product flow starts, the SDK collects the relevant data, and then uploads it to Fourthline.

At each step, the original browser window displays the client's progress.

Progress screen

Progress screen

Tip
Clients may not know how to take photos with appropriate lighting, background, and framing, which can lead to processing delays or unnecessary rejections.
The Web SDK UI provides clients clear instructions and real-time feedback to optimize image quality, and additional guidance if required.
Fourthline ensures the photos were taken during the workflow, in compliance with art. 41b of the European Banking Authority – Guidelines on the use of Remote Customer Onboarding Solutions under Article 13(1) of Directive (EU) 2015/849.

Successful flow

If the client successfully completes the workflow, the UI displays a success message.

If you provide us a URL to your own success page, we display a Redirect button the client can tap to go to your page, or they are automatically redirected there after 5 seconds.

If you don't provide a success page URL, we display text telling the client to return to your website.

Left: Success page URL provided | Right: No success page URL provided

Left: Success page URL provided | Right: No success page URL provided

Unsuccessful flow

If the client doesn't complete the workflow successfully or if required data isn't provided, the UI displays a Failure screen.

If you provide a URL to your own failure page, we display a Continue button the client can tap to go to your page, or they are automatically redirected after 5 seconds.

If you don't provide a failure page URL, we display text telling the client to return to your website.

Left: Failure page URL provided \\ Right: No failure page URL provided

Left: Failure page URL provided | Right: No failure page URL provided

Expiry or error

If the session expires because the client took too long or something goes wrong during the workflow (e.g. the validation code is invalid or not provided or there is an unexpected runtime error), the UI displays the relevant error message:

Left: Session expired message \\ Right: Error message

Left: Session expired message | Right: Error message



How to integrate

Support
For any questions, contact your implementation manager.

Top of page