SDK Customisations

Stages

Stages can be customised by providing stage objects. A state object has two components - name and options.

Name

The name attribute is the stage name. The possible values are: intro, userConsentCapture, documentCapture, faceCapture, poaCapture,and completion.
When the userConsentCapturestage is enabled, the onExit callback must be used to handle instances where your client does not grant their consent to be checked as per our prevailing Terms of Services and Privacy statement. Please refer to SDK Settings for further details on the onExit callback.

Options

The options object allows the customisation of each stage as follows:
Stage Name
Options
intro
  • heading: change the intro screen heading
  • message: a list of messages to display on the intro screen. Max size 3.
  • startButtonText: change the text of the start button on the intro screen.
documentCapture
  • crossDeviceOnly: a boolean that indicates whether to force users to capture their document using their phone. This removes the document upload option.
  • documentTypes: the list of ID document types visible to the user. Valid document types include:
    • passport
    • driving_license
    • national_identity_card
    • residence_permit
    The value of each can be either a boolean or a country object. Boolean values toggle the visibility of the document type. The country object allows to specify the issuing country for non-passport document types and thus bypass the country selection screen. The country value is the two-letter country ISO code.
faceCapture
  • mode: the mode of the facial capture. Possible values are: photo or video.
poaCapture
  • documentTypes: the list of Proof of Address (poa) document types visible to the user. Valid poa document types include:
    • bank_statement
    • utility_bill
The value of each document type is a boolean that toggles the visibility of the document type.
completion
  • heading: change the completion screen heading.
  • message: a message to display on the completion screen. Max size 1.

Example options object

1
stages: [
2
{
3
name: "intro",
4
options: {
5
heading: "We need verify your identity",
6
message: [
7
"In order to open an account, we need check a few things.",
8
"This will take only a moment",
9
],
10
startButtonText: "Start Verification"
11
},
12
},
13
"userConsentCapture",
14
{
15
name: "documentCapture",
16
options: {
17
crossDeviceOnly: true,
18
documentTypes: {
19
passport: true,
20
driving_license: false,
21
national_identity_card: true,
22
residence_permit: {
23
country: "GB",
24
},
25
},
26
},
27
},
28
{
29
name: "faceCapture",
30
options: {
31
mode: "video"
32
},
33
},
34
{
35
name: "poaCapture",
36
options: {
37
documentTypes: {
38
bank_statement: true,
39
utility_bill: false,
40
},
41
},
42
},
43
{
44
name: "completion",
45
options: {
46
heading: "Thank you for completing the process",
47
message: ["we will get in touch shortly"]
48
},
49
},
50
];
51
Copied!

Branding

If you'd like to customise the look-and-feel of the SDK, you can provide a branding object with the following attributes:

Appearance

The appearance object allows you to customise the colour scheme of the SDK with CSS values (e.g. RGBA, Hex). Customisable attributes include:
Attribute
Description
infoPopupColor
Warning popup background colour
infoPopupTextColor
Warning popup background colour
infoPopupLinkHoverColor
Warning popup fallback Link on hover background colour
infoPopupLinkActiveColor
Warning popup fallback Link active background colour
errorPopupColor
Error popup background colour
errorPopupTextColor
Error popup text colour
errorPopupLinkHoverColor
Error popup fallback Link on hover background colour
errorPopupLinkActiveColor
Error popup fallback Link active background colour
cameraButtonHoverColor
Camera button on hover background colour
cameraButtonActiveColor
Camera button active background colour
iconButtonActiveColor
Icon button active background colour
iconButtonHoverColor
Icon button on hover background colour
primaryButtonColor
Primary button background colour
primaryButtonTextColor
Primary button text colour
primaryButtonActiveColor
Primary button active background colour
primaryButtonHoverColor
Primary button on hover background colour
primaryButtonBorderColor
Primary button border colour
secondaryButtonColor
Secondary button background colour
secondaryButtonTextColor
Secondary button text colour
The logo object has two attributes:
  • lightLogoUrl: URL for your logo's light version
  • darkLogoUrl: URL for your logo's dark version

Example of logo branding

1
branding: {
2
appearance: {
3
primaryButtonColor: '#FF0000',
4
},
5
logo: {
6
lightLogoUrl: 'light_logo_url',
7
darkLogoUrl: 'dark_logo_url',
8
}
9
},
Copied!

Text Brand

The textBrand attribute represents the textual format of your brand.

Example of text branding

1
branding: {
2
appearance: {
3
primaryButtonColor: '#FF0000',
4
},
5
textBrand: 'Acme Bank'
6
}
Copied!
If logo and textBrand attributes are specified at the same time, logo takes precedence.