Import questionnaire to calculate applicant risk score

Easily determine the risk score of your applicants using Questionnaires.

To calculate the applicant risk score with the help of questionnaires:

  1. Create a new questionnaire.
  2. Create a verification level with the Questionnaire step and specify your questionnaire.
  3. Recreate a questionnaire structure on your side (in your code). The structure must contain the following:
    • A questionnaire id.
    • The sections object with IDs of sections. Each section contains the items object with IDs of items; items contain value.
{
  "externalUserId": "your_external_user_id",  //External user ID
  "questionnaires": [  //Questionnaire object
    {
      "id": "questionnaire_id",  //Questionnaire ID
      "sections": {
        "personalInfo": {  //Section ID
          "items": {
            "countryItem": {  //Item ID 
              "value": "GBR"  //Item value
            },
            "textAreaItem": {
              "value": "text area test"
            },
            "phoneItem": {
              "value": "+1 123 456 78901"
            },
            "selectDropdownItem": {
              "value": "no"
            },
            "dateItem": {
              "value": "1990-01-01"
            },
            "textItem": {
              "value": "text item test"
            },
            "boolItem": {
              "value": "true"
            },
            "selectItem": {
              "value": "yes"
            },
            "dateAndTimeItem": {
              "value": "1990-01-01T00:00"
            },
            "multiSelectItem": {
              "values": [
                "gambling",
                "cryptocurrency",
                "software"
              ]
            }
          }
        }
      }
    }
  ]
}
  1. Create an applicant that will be used for transaction monitoring:
    • In the levelName parameter, provide the name of the applicant level created at step 2.
    • In the questionnaires array, provide the questionnaire structure created at step 3.
  2. Request an applicant check to create an onboarding (KYC) transaction and calculate the risk score based on the questionnaire answers.

🚧

Important

The Create KYC transactions during onboarding checkbox must be selected in the general level settings.