Example configurations

This page contains example configuration objects for Smart UI. To include these examples in your own code, pass the example configuration object as the value of the config field. Don’t pass the example configuration directly to the intialiseOnboardingWidget() method.

Correct:

1
frankieFinancial.initialiseOnboardingWidget({
2
  ffToken: "TOKEN",
3
  applicantReference: "YOUR_CUSTOMER_REFERENCE",
4
  width: "AUTO",
5
  height: "AUTO",
6
  config: {
7
    // example configuration here
8
  }
9
});

Incorrect:

1
frankieFinancial.initialiseOnboardingWidget({
2
  // example configuration here
3
});

Accept passports from countries different to address

The documentTypesconfiguration field supports specifying document types as objects, where you can define the specific countries accepted for that document type.

An array of acceptable countries can be specified for documentTypes and requestAddress separately.

{
  "documentTypes": [
    {
      "type": "PASSPORT",
      "acceptedCountries": ["NZL"],
    {
      "type": "NATIONAL_ID",
      "acceptedCountries:" ["IDN"]
    }
  ],
  "requestAddress": {
    "acceptedCountries": ["BRA"]
  }
}

If neither is specified the top-level acceptedCountries configuration field will be used.

{
  "acceptedCountries": ["NZL", "IDN", "BRA"]
}

You can specify the string "ALL" in place of an array to accept documents from any country.

1
{
2
  "documentTypes": [
3
    {
4
      "type": "PASSPORT",
5
      "acceptedCountries": "ALL"
6
    }
7
  ]
8
}

Capture Social Security Number (United States)

We don’t support an explicit SSN field, but you can tailor the “National ID” document type to appear as an SSN field.

Specify a custom document type as well as customising the label text.

{
  "documentTypes": [
    "PASSPORT",
    {
      "type": "NATIONAL_ID",
      "label": "Social Security Number",
      "subtitle": "Citizen or Green Card holder"
    }
  ],
  "phrases": {
    "national_id_input_screen": {
        "title": "Your Social Security Number",
        "title_loop": "Check your Social Security Number"
    },
    "document": {
        "type_national_id": {
            "identification_number": "Social Security Number",
            "name": "Name as shown on card",
            "nationality": "Nationality"
        }
    }
  }
}

Fraud Device/Phone/Email

Below is an example to enable the device/behaviour gathering and send across Email/Phone of the entity.

enableDeviceCharacteristics: true,
            preload: {
              email: "example@example.com",
              phone: "+61400000000",
            },