SDK Customisations

Search…
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
secondaryButtonActiveColor
Secondary button active background colour
secondaryButtonHoverColor
Secondary button on hover background colour
secondaryButtonBorderColor
Secondary button border colour
documentSelectorColor
Document selector background colour
documentSelectorTextColor
Document selector text colour
documentSelectorActiveBorderColor
Document selector active background colour
documentSelectorHoverBorderColor
Document selector on hover background colour
linkHoverColor
Link on hover background colour
linkActiveColor
Link active background colour
linkUnderlineColor
Link underline colour
linkHoverTextColor
Link on hover text colour
bodyTextColor
SDK content text colour
headingTextColor
SDK heading text colour
subheadingTextColor
SDK subheading text colour
Logo
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.
​