About consent

When performing an identity check, many sources require that you gain consent from your customers to access certain data. This is most common with credit and government sources. There will be a need to speak with your AML team and the FrankieOne team to determine what consent flags you need to supply.

KvpKey	KvpType	KvpValue	Notes
consent.general	general.bool	`true` or `false`	This indicates that the entity has given consent for their name/address/DoB to be checked against our various databases and external services.
consent.docs	general.bool	`true` or `false`	This indicates that the entity has given consent to have their identity documents checked against official sources
consent.creditheader	general.bool	`true` or `false`	This indicates that the entity has given permission to have their details checked against a credit bureau service. If this check fails, you must inform the user that the check failed and put them in touch with the bureau directly so that they may update their details as necessary. This is not normally available by default, so please see your account manager about making this service available
consent.under18	general.bool	`true` or `false`	This indicates that the entity is under the age of 18 and a parent or guardian has provided consent. This is a special case of the consent.general flag (see above). consent.docs would still be required to check their passports/drivers licence.
consent.payroll	general.bool	`true` or `false`	This consent is used to allow access to verifying an identity using payroll data
consent.insurance	general.bool	`true` or `false`	This consent is used to allow access to verifying an identity using workcover data
consent.superannuation	general.bool	`true` or `false`	This consent is used to allow access to verifying an identity using superannuation data

❗️
Consents are Important
Where consent is critical or required by law, then you MUST obtain it from your customers, and MUST set it before requesting our service.
If that is not done, then it would be noticed that the service does not attempt you use those consented sources, or rejects the verification request altogether.
Please speak with the FrankieOne customer success team if you're unsure about your options.

📘
Please ensure consent is passed through in the entity extra data area

{
    "entity": {
        "addresses": [
            {
                "country": "CAN",
                "postalCode": "K1A0A1",
                "state": "ON",
                "streetNumber": "1416",
                "streetName": "Huffine Ln.",
                "town": "Ottowa",
                "longForm": "1416 Huffine Ln."
            }
        ],
              "identityDocs": [
   {
      "country" : "CAN",
      "idNumber" : "+3435569999",
      "idType" : "MSISDN"
    }],
        "dateOfBirth": {
            "dateOfBirth": "1957-08-17".
        },
        "entityProfile": "standard_kyc",
        "extraData": [
            {
                "kvpKey": "customer_reference",
                "kvpType": "id.external",
                "kvpValue": "CANADA-00212312"
            },
            {
                "kvpKey": "consent.general",
                "kvpType": "general.bool",
                "kvpValue": "true"
            },
            {
                "kvpKey": "consent.docs",
                "kvpType": "general.bool",
                "kvpValue": "true"
            },
            {
                "kvpKey": "consent.creditheader",
                "kvpType": "general.bool",
                "kvpValue": "true"
            }
        ],
        "name": {
            "familyName": "Canada",
            "middleName": "",
            "givenName": "Test",
            "displayName" : "Test Canada"
        }
    }
}

❗️Consents are Important

📘

❗️
Consents are Important