Hosted Integration (Web Link)

General
In case you'd rather have the verification process handled outside of your application, you can send your users to an URL, that is managed directly on Passbase. 
You can get your own customizable organization slug. e.g. https://verify.passbase.com/YOURCOMPANY
1
https://verify.passbase.com/:organization_slug
Copied!
An example of this solution is this Passbase Demo.
If you haven't done so before, head towards app.passbase.com and turn on 'Enable V2 for your verification link'.
Prefilling Data: User Email & Country
In order to prefill the email of a verification & skip this step or to preselect a country from the dropdown, you can pass a base64 encoded parameter string at the end of the request like below.
1
// Your Link 
2
https://verify.passbase.com/:organization_slug
3
​
4
// Your link including an encoded string for customizations
5
https://verify.passbase.com/:organization_slug?p={BASE64_ENCODED_STRING}
Copied!
The encoded object should be a JSON object consisting of the following (optional) key-value pairs:
Key
Value
prefill_attributes
email:  Populate this field if you already know your users' email address to speed up the verification flow. 
​
country: An ISO-3166 compliant country code. For the ID document country selection screen, this will pre-select the country of the ID document in the dropdown menu for  your users
​
metadata: Encrypted JSON string via the private key encoded in base64
Tool: Passbase Link Encoder
If you don't want to build this functionality into your backend, you can also use this tool to encode your hosted link with a user email online: Passbase Link Encoder​
The code for this project is on Github here.
Example for Your Own Application
Below is an example where we prefill an user's email and set the country for the top document of the id document list to Germany:
JavaScript
Python
Ruby
PHP
1
const prefillAttributes = {
2
    prefill_attributes: {
3
      email: "[email protected]",
4
      country: "de"
5
    },
6
    metadata: "MY_ENCRYPTED_METADATA_STRING" //optional
7
  }
8
const objJsonStr = JSON.stringify(prefillAttributes);
9
const objJsonB64 = Buffer.from(objJsonStr).toString("base64");
10
​
11
// Your Link
12
const link = "https://verify.passbase.com/" + "YOUR_SLUG" + "/?p=" + objJsonB64
13
​
14
// Result:
15
// https://verify.passbase.com/YOUR_SLUG/?p=eyJwcmVmaWxsX2F0dHJpYnV0ZXMiOnsiZW1haWwiOiJ1c2VyQGVtYWlsLmRlIiwiY291bnRyeSI6ImRlIn19
Copied!
1
import json
2
import base64
3
​
4
yourCompanySlug = "mathias"
5
yourPassbaseLink = "https://verify.passbase.com/" + yourCompanySlug
6
​
7
prefillAttributes = {
8
    "prefill_attributes": {
9
        "email": "[email protected]",
10
        "country": "de"
11
    },
12
    "metadata": "MY_ENCRYPTED_METADATA_STRING" //optional
13
}
14
jsonString = json.dumps(prefillAttributes)
15
encoded = base64.b64encode(jsonString.encode('utf-8'))
16
encodedStr = str(encoded, "utf-8")
17
link = yourPassbaseLink + '?p=' + encodedStr
18
​
19
# Result
20
# https://verify.passbase.com/YOUR_SLUG?p=eyJwcmVmaWxsX2F0dHJpYnV0ZXMiOiB7ImVtYWlsIjogInVzZXJAZW1haWwuZGUiLCAiY291bnRyeSI6ICJkZSJ9fQ==
Copied!
1
require "base64"
2
require 'json'
3
​
4
yourCompanySlug = "mathias"
5
yourPassbaseLink = "https://verify.passbase.com/" + yourCompanySlug
6
​
7
preFillAttributes = {'prefill_attributes' => {
8
    'email' => '[email protected]',
9
    'country' => 'de'
10
  },
11
    'metadata' => 'MY_ENCRYPTED_METADATA_STRING'
12
}
13
encoded = Base64.strict_encode64(preFillAttributes.to_json)
14
link = yourPassbaseLink + "?p=" + encoded
15
​
16
# Result
17
# https://verify.passbase.com/YOUR_SLUG/?p=eyJwcmVmaWxsX2F0dHJpYnV0ZXMiOnsiZW1haWwiOiJ1c2VyQGVtYWlsLmRlIiwiY291bnRyeSI6ImRlIn19
Copied!
1
$slug = "mathias";
2
$yourPassbaseLink = "https://verify.passbase.com/".$slug;
3
​
4
$hash_map = array(
5
        'prefill_attributes' => array(
6
                'email' => '[email protected]',
7
                'country' => 'de'
8
            ),
9
            'metadata' => 'MY_ENCRYPTED_METADATA_STRING' #optional
10
        );
11
​
12
$encodedAttributes = base64_encode(json_encode($hash_map));
13
$encodedLink = $yourPassbaseLink."?p=".$encodedAttributes;
14
​
15
# Result
16
# https://verify.passbase.com/YOUR_SLUG/?p=eyJwcmVmaWxsX2F0dHJpYnV0ZXMiOnsiZW1haWwiOiJ1c2VyQGVtYWlsLmRlIiwiY291bnRyeSI6ImRlIn19
Copied!

web - client-side SDKs - Previous

Angular

iOS

Last modified 1mo ago

Copy link

Contents

General

Prefilling Data: User Email & Country

Tool: Passbase Link Encoder

Example for Your Own Application