Veriff Integration Guide

To learn more about Veriff, check out veriff.com

Verify Identity Document

The Verify Identity Document step allows you to run IDV checks for a given user within your application using Dodgeball.

Configuring Webhooks

Warning: In order for IDV to work with Veriff, it is critical that you configure your Veriff Webhooks to inform Dodgeball about verification decisions.

Veriff sends verification decision information via webhooks. See the Veriff developer documentation for instructions on setting those webhook URLs.

Dodgeball listens for events from Veriff's Webhook decisions URL at the following location:

${dodgeballApiBaseUrl}/v1/webhooks/veriff/decision

In the URL above, ${dodgeballApiBaseUrl} is a placeholder for the Dodgeball API Base URL. This may vary depending on your environment. If you are unsure which Base URL to use, please reach out to our support team.

Adding Veriff IDV to a Checkpoint and Processing Results

1. From the Step Palette click on the Services tab. Scroll down until you see the IDENTITY VERIFICATION & KYC dropdown, then drag the Veriff: Verify Identity Document step into the checkpoint flow diagram.
2. Connect the step into the diagram where you want it to run.
3. Click on the Step to open up the flyout configuration.

From the flyout:

• If you want the client verification process to timeout after a certain period, check the box under the Timeout header and choose a duration. If a verification times out, it will be considered a failed IDV check with a "Result Type" of TIMEOUT.
• If you want to continue processing the workflow after a failure, keep the Continue on Failure box checked. This is the recommended approach as it gives you more granular control over the workflow.

Important: It is critical that you use a Decision block to determine your next steps after performing ID Verification, especially if Continue on Failure is checked.

You can also check the Result Type for more specific routing. Possible Result Types include:

• PENDING
• USER_ERROR
• USER_CANCEL
• TIMEOUT
• SUCCESS
• FAILURE