Plaid logo
Docs
ALL DOCS

Identity Verification (early access)

  • Introduction to Identity Verification
  • Webhooks
  • Testing in sandbox
  • Hybrid input validation
Plaid logo
Docs
Plaid.com
Get API keys
Open nav

Webhooks

Subscribe to events and get real-time alerts for changes

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.

Event ordering

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.

Webhook Reference

For full webhook information, refer to the API Documentation.

Was this helpful?
Developer community
Github logo
Github logo
StackOverflow logo
StackOverflow logo
Twitter logo
Twitter logo