Redirection Guide

Veriff Redirection solution allows you to redirect your end-users to Veriff web flow.

Requirements and prerequisites

Prerequisites

  • You have an active account with Veriff (see the Getting Started section)

  • You have an integration with Veriff (see the Getting Started section)

  • You have set up webhook(s) to get replies from Veriff (see the Webhooks section)

  • You have integrated a solution that allows you to create session URLs for your end-users (using the API POST /sessions[↗] call or Javascript SDK)


Add SDK to the project

Step 1: Create a session URL

You need to have a Veriff session URL generated before initializing the SDK.

You have two options:

  • see the POST /sessions[↗] in API documentation to learn how to generate a session URL via API call

  • use the JavaScript SDK to create the session URL

Step 2: Redirect the end-user to the flow

After receiving the session URL you can redirect end-users there by using following function:

window.location.href = url;

What happens after the end-user leaves the flow?

When a session is canceled or finished, we try to redirect the end-user to the callback URL, or close the browser if the callback URL is not present.


Verification session decision

Veriff returns info about the verification session decision, extracted data, registries checks etc via webhooks. You need to set up webhooks and tie them to your system.

→ See Webhooks Guide > Set up webhooks sub-section for detailed overview of the setup process


Customize the SDK

SDK customization is optional

In the redirection flow, it is possible to customize the end-user interface language.

User interface language settings

It is possible to use the lang parameter to change the language. To change it, add the lang as query parameter to the URL:

https://magic.veriff.me/v/{sessionURLtheEndUserIsRedirectedTo}?lang=es

→ See Supported languages in SDKs article for more info