Webhooks

Once you have Link with Identity Verification embedded in your app, you should be able to complete an entire session and review it in the dashboard.

To complete your integration, you need to add a webhook receiver endpoint to your application.

First, visit the dashboard webhook configuration page and click New Webhook.

You can select which events you want to subscribe to. For Identity Verification, there are three events:

• STEP_UPDATED
• STATUS_UPDATED
• RETRIED

Enter your webhook receiver endpoint for the webhook you wish to subscribe to and click Save. Plaid will now send an HTTP POST request to the webhook receiver endpoint every time the event occurs.

Identity Verification does not guarantee that webhooks will be delivered in any particular order. For example, while the logical ordering of webhooks for a Identity Verification session might look like this:

1. STEP_UPDATED The user has started the Identity Verification session and is on the first step
2. STEP_UPDATED
3. STATUS_UPDATED The user has reached a terminal state for their session
4. RETRIED A retry has been requested for this user, either via the dashboard or via API
5. STEP_UPDATED
6. STEP_UPDATED
7. STATUS_UPDATED The retry has been completed

you should be prepared to handle these events in any delivery order. For example, consider whether your application will properly handle:

• A STEP_UPDATED event being delivered after a STATUS_UPDATED event.
• A STEP_UPDATED event being delivered before an associated RETRIED

In order to properly handle webhook events being delivered out of order, your application should lookup the user's associated session(s) via our /identity_verification/list/ API.

For full webhook information, refer to the API Documentation.