Webhook Events

Learn about the webhook events triggered when using ZWITCH's PAN verification service.

We use webhooks to notify you about important events on your KYC verification. These webhooks contain details about the event such as changes that occurred and the resources impacted by the change.

We send webhooks as HTTP POST call to a URL configured by you. The webhook payload uses the JSON format.

Learn more about our Webhooks.

Available Events

The table below lists the various webhook events triggered when verifying an individual’s or business’s PAN.

Webhook EventsDescription
kycs.pan.createdTriggered when the PAN Verification API call is successfully made.

Sample Payloads

KYCs PAN Created

Triggered when the PAN Verification API call is successfully made.

{
  "id": "evl_ZGLJvhbGJkoU3809TIO7knP5T",
  "object": "event",
  "name": "kycs.pan.created",
  "is_sandbox": true,
  "data": {
    "object": {
      "id": "pan_ePEDG0YY3jkdk9ootiNjhhpDX",
      "object": "pan_verification",
      "pan": "AAAAA0987A",
      "name_on_pan": "Anil Reddy",
      "status": "success",
      "merchant_reference_id": "1000987",
      "metadata": {
        "key_1": "DD",
        "key_2": "XOF"
      },
      "created_at": 1655281885,
      "is_sandbox": true
    }
  }
}