Hosted Integration (Web Link)

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

Overview

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. https://verify.passbase.com/YOURCOMPANY

https://verify.passbase.com/:organization_slug

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 support@passbase.com if you want it enabled for your account.

Customization

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.

https://verify.passbase.com/:organization_slug?p=aGV5IGFuZHJldyB3aGF0J3MgdXA=

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

Key

Value

additional_attributes

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

prefill_attributes

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}}")