API Reference

Web SDK Setup

Fourthline's Web SDK smoothly redirects users from your website via QR code or SMS to a new browser window on their mobile device. The product workflow on the device is hosted by Fourthline on a secure, private subdomain. Alternatively, you can embed the SDK in your mobile site.

The SDK takes care of the user journey and orchestrates modules with a streamlined API flow. You can also easily level up from single products to multi-product solutions with no additional API requests.

All required images and data are captured in our best-practice UI. and automatically uploaded to Fourthline for processing. You never handle sensitive personal data.



Flow

User interface

Fourthline provides the mobile-responsive UI, which is built in line with industry-standard best practices for user experience (UX):

  • The UI includes guidance and animations to help users understand the journey.
  • Users may not know how to take photos with appropriate lighting, background, and framing, which can lead to processing delays or unnecessary rejections. The UI provides users clear instructions and real-time feedback to optimize image quality and maximise conversion.
  • The UI validates data entered by users in real time to reduce input errors.
  • You can localize the UI text in a range of languages, and customize fonts and colors to match the look-and-feel of your brand.
  • Fourthline collects analytics data and continually updates the UI to improve conversion, meet evolving regulatory requirements, and keep pace with market trends in UIs and UX.

Redirect flow

You can redirect users from your desktop or mobile website to the product workflow in a new browser window on their mobile device via QR code or a link in an SMS. This flow is typically hosted by you and embedded in your website.

QR code redirect

You display a QR code to the user on your website, which they scan with their mobile device. The QR code is unique for each SDK session.

QR code redirect

SMS redirect

The user receives the workflow URL via SMS.

  • The user enters the valid phone number of their mobile device, and then clicks or taps Request SMS.
  • While awaiting the SMS, the user can check their mobile phone number is correct.
  • If the countdown reaches zero and the user still hasn't received an SMS, they can click or tap Try again to go back and re-enter the phone number.
  • The user can re-request the SMS a maximum of 3 times.
SMS link redirect

Desktop website

If the user is accessing your website via their desktop browser, initialise the Web SDK, display the redirect options, and then redirect the user to the workflow URL in their mobile browser.

Mobile website

If the user is accessing your website via their mobile browser, there are 2 options:

  • You display the redirect options, and then redirect them to the workflow URL on your subdomain.
  • If the SDK detects the user'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