Authorized Representative

Purpose

To confidently assume that the user is legally authorized to represent a company, you have to order the “authorizedRepresentative” credential.

There are more options and special consideration to take into account. Please refer to the full documentation if any questions arise.

Order

A Minimal Order

If you don’t care about the company the user has authority over, you can simply define your order like this:

{
  "verifierId": "[VERIFIER_ID]",
  "webhook": "[WEBHOOK_ADDRESS]",
  "redirects": {
    "success": "[SUCCESS_REDIRECT]",
    "failure": "[FAILURE_REDIRECT]"
  },
  "requiredCredentials": [
    "authorizedRepresentative": true
  ]
}

From here you can add additional credentials as needed.

The “authorizedRepresentative” credential credential will enforce, that the user goes through the video identification process that ensures the correctness of the personal information (name, date of birth, address, …). The credential also ensures the existence of basic company data the user has authority over.

Add the Auto Ident Method

For historic reasons by default only the video ident identification method will be accepted and offered. To enable the less “invasive” auto ident method extend the order like so:

{
  "verifierId": "[VERIFIER_ID]",
  "webhook": "[WEBHOOK_ADDRESS]",
  "redirects": {
    "success": "[SUCCESS_REDIRECT]",
    "failure": "[FAILURE_REDIRECT]"
  },
  "requiredCredentials": [
    "authorizedRepresentative": true
  ],
  "acceptedIdMethods": ["itm_videoident", "nect_autoident"],
  "offeredIdMethods": ["itm_videoident", "nect_autoident"],
}

Ensure authority over a specific company

If you want the proof of authority over a specific company you add the forOrg parameter:

{
  "verifierId": "[VERIFIER_ID]",
  "webhook": "[WEBHOOK_ADDRESS]",
  "redirects": {
    "success": "[SUCCESS_REDIRECT]",
    "failure": "[FAILURE_REDIRECT]"
  },
  "requiredCredentials": [
    "authorizedRepresentative": true
  ],
  "forOrg": {
    "crefoId": "1231234567",
    "mandatory": true
  }
}

Pitfalls

The ID method “pin-letter” is not compatible with the “authorizedRepresentative” credential, since using pin-letter doesn’t aquire the base information necessary to issuer an “authorizedRepresentative” credential.