Verification Webhook Events

AuthSetu asynchronously delivers webhook events whenever an identity check transitions to a terminal state.

Subscribed Event Types

---

Event Payload Structure

{
  "id": "evt_0192837465aa",
  "event": "verification.completed",
  "created_at": "2026-10-13T13:30:00Z",
  "data": {
    "request_id": "req_pan_0192837465ab",
    "verification_type": "pan",
    "status": "verified",
    "customer_ref": "cust_usr_991823",
    "result": {
      "pan": "ABCDE1234F",
      "name_on_card": "AARAV SHARMA",
      "category": "individual",
      "is_valid": true,
      "name_match_score": 1.0
    }
  }
}

Security & Verification

All webhook requests include the `X-AuthSetu-Signature` HMAC-SHA256 signature header computed with your endpoint signing secret (`whsec_...`).

See [Signature Verification](/docs/webhooks/verify-signatures) for code samples in TypeScript, Python, and Go.