Skip to main content

Step A: Set up your Onfido account

Before you begin, open two browser windows side by side: one signed in to your IDaaS administrator account and one signed in to your Onfido administrator account. You need both windows open because you copy values from Onfido into IDaaS, then copy values from IDaaS back into Onfido.

  • If you are setting up a test environment, use Onfido sandbox values.
  • If you are setting up production, use live values and confirm that your webhook notifications are enabled in both environments.

Step 1: In Onfido, generate an API token​

  1. From the Onfido Dashboard page, click Developers > Tokens. The API tokens list appears.
  2. Click Generate API token. The Generate API token dialog box appears.
  3. Click one of the following options:
    • Live to perform a full registration and authentication.
    • Sandbox to create a test environment.
  4. Click Generate. The Generate API token dialog box appears.
  5. Copy the generated token. You need to paste this value into IDaaS.

Step 2: In IDaaS, paste the API token value and copy the Webhook URL​

  1. In IDaaS, click > Configuration > Onfido Account. The Onfido Account page appears.
  2. In the API Key field, paste the API token you copied from Onfido in Step 1: In Onfido, generate an API token.
  3. Copy the Webhook URL that appears under Use this URL to create a Webhook.
  4. Leave this page open.

Step 3: In Onfido, add the Webhook URL and generate a Webhook token​

  1. In Onfido, click Developers > Webhooks. The Webhooks page appears.
  2. Click Create Webhook. The Create Webhook dialog box appears.
  3. In the URL field, paste the URL you copied in Step 2: In IDaaS, paste the API token value and copy the Webhook URL.
  4. Under Status, select Enabled.
  5. Under Environments, click Both.
  6. Under Select event notifications disable all options with the exception, workflow_run.completed.
  7. Click Save to create the Webhook.
  8. The new Webhook appears in the Webhooks page.
  9. Copy the Token value generated for your new Webhook.

Step 4: In IDaaS, add the Onfido Webhook token​

  1. In the IDaaS Onfido Account page, do the following:
  2. In the Webhook Token field, paste the token you copied in Step 3: In Onfido, add the Webhook URL and generate a Webhook token.
  3. Select the API Region where the API key is created.
  4. Click Save.