> For the complete documentation index, see [llms.txt](https://docs.vida.id/identity-stack/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.vida.id/identity-stack/identity-operation-center/fraud-ops/liveness-fraud-ops/webhook-notification.md).

# 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

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

<table><thead><tr><th width="172.53125">Field</th><th width="123.52734375">Type </th><th>Description</th></tr></thead><tbody><tr><td>transaction_id</td><td>string</td><td>The reference transaction UUID of the original liveness or KYC transaction from VIDA</td></tr><tr><td>assessment</td><td>string</td><td>Result of the manual review by specially-trained human.<br><code>SPOOF</code> indicates a confirmed fraud by human agent</td></tr><tr><td>reason</td><td>string</td><td>Brief explanation of the attack and spoof type</td></tr><tr><td>ticketId</td><td>string</td><td>Unique reference ID to the manual review ticket, for auditing or support purpose</td></tr></tbody></table>

## 2. Liveness Transaction Detail API

To see the Fraud Ops verdict, you can use the [Liveness Transaction Detail API](/identity-stack/identity-operation-center/fraud-ops/liveness-fraud-ops/liveness-status-api.md).