> 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/verify/liveness/integration/liveness-sdk/liveness-fraud-ops/fraud-ops-notification.md).

# Fraud Ops 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

<details>

<summary>Sample Payload</summary>

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

</details>

<table><thead><tr><th width="149.780029296875">Field</th><th width="104.2867431640625">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.&#x20;

Please refer to [ID Fraud Shield Disabled](/identity-stack/verify/liveness/integration/api/api-reference/liveness-transaction-details-api/id-fraud-shield-disabled.md#api-response-1) to understand the endpoint and the sample response.