Webhook Notification

When VIDA detects potential fraud through its Fraud Ops, by a specially-trained human, you can receive the notification via webhook, or actively hit the Liveness Transaction Details API.

This real-time alert allows enterprise system to take immediate action to protect the business (e.g.: block issuance, terminate sessions, trigger fraud response flows).

1. Webhook Notification

How to set up webhook?

Please provide a webhook URL to VIDA implementation team. Webhook sends a JSON payload to the client's provided URL

Sample Payload

{
  "transaction_id": "f495a812-1265-432f-91c9-c0e79d634121",
  "assessment": "SPOOF",
  "reason": "Injection Attack-Background Manipulation",
  "ticketId": "01K06RTXZ3P9411FWPCQJJ9V321"
}

Field	Type	Description
transaction_id	string	The reference transaction UUID of the original liveness or KYC transaction from VIDA
assessment	string	Result of the manual review by specially-trained human. SPOOF indicates a confirmed fraud by human agent
reason	string	Brief explanation of the attack and spoof type
ticketId	string	Unique reference ID to the manual review ticket, for auditing or support purpose

2. Liveness Transaction Detail API

To see the Fraud Ops verdict, you can use the Liveness Transaction Detail API.