Hosted Integration (Web Link)

This document explains how to integrate the Authentication flow outside of your web application


In case you'd rather have the verification process handled outside of your application, we can provide you an URL with a working integration managed directly on Passbase.

You can get here your own customizable organization slug. e.g.

And example of the verification via link feature is our Passbase Demo.

This feature is only available for approved clients. Please get in touch with us at if you want it enabled for your account.


In order to customize the behavior of the component according to your needs, you can pass a base64 encoded parameters object in the request as explained below.

The decoded value shall be a JSON object consisting of the following (optional) key-value associations:




A JSON RFC-7159 compliant object where to store useful references for your application (User IDs, etc.)


email: Populate this field if you already know your users' email address to speed up the authentication flow.


country: An ISO-3166 compliant country code. Populate this field if you already know your users' nationality to speed up the authentication flow.

Encoding example (Ruby)

require "base64"
Base64.encode64("{\"additional_attributes\": {\"customer_id\": 12345}}")