Skip to main content
All CollectionsVerification sessions
Receiving data via Webhooks
Receiving data via Webhooks
Francesco Malvestio avatar
Written by Francesco Malvestio
Updated over 3 weeks ago

What are Webhooks?

Webhooks allow Veriff to send real-time data (payloads) to your server whenever specific events occur, such as session status changes or verification decisions. This is an automated push mechanism, which means Veriff sends the data to your server without you needing to request it repeatedly.

If you would like to know more about webhooks, you can check this article.

Receive real-time verification data with Veriff Webhooks

Want to automate how you receive verification updates?

💡 Watch this video to learn how to:

Set up Webhooks. Automatically receive event and decision data from Veriff without manual requests.

Capture key verification events. Get instant updates when a session starts, is submitted, approved, or declined.

Secure & store data. Save payloads to your database and verify authenticity using HMAC signatures.

🎥 Watch now and start receiving real-time verification data!


Step-by-step process

How to receive data via Webhooks

  1. Set Up Your Webhook Endpoint

    • Configure a URL (your server's endpoint) where you want to receive data from Veriff.

    • Follow these steps:

      • Go to the Veriff environment.

      • Navigate to Integrations > Settings.

      • Enter your Webhook URL where Veriff will send the payloads.

  2. Receive Data on Webhook Events

    • Veriff will send payloads (data) when specific events occur. For example:

      • Decision Payload: Contains verification results like approved, declined, etc.

      • Event Payload: Includes lifecycle updates like started, submitted.

  3. Secure the Data

    • Verify that the webhook payloads originate from Veriff using the X-HMAC-SIGNATURE header.

  4. Store and Process the Data

    • Once the payloads hit your webhook endpoint, save them to your database or data storage system for further analysis or reporting.

Did this answer your question?