Webhook Events

All important activity on your ZWITCH account is recorded as an event. We use webhooks to notify you about important events on your account. 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. Webhook payloads use the JSON format.

Learn how to set up webhooks.

Available Webhook Events

The table below lists the various webhook events triggered when verifying a bank account or VPA handle.

Webhook Event	Description
`verifications.bank_account.created`	Triggered when the Bank Account Validation API call is successfully made.

Sample Payloads

Below are sample payloads for the different Account Verification webhook events.

Verifications Bank Account Created

Triggered when the Bank Account Validation API call is successfully made.

{
  "id": "evl_EIIEsCyLKw38snt9oefLc2dNZ",
  "object": "event",
  "name": "verifications.bank_account.created",
  "is_sandbox": true,
  "data": {
    "object": {
      "id": "accver_X7VSZPiWtWRy1knq15ZVA8Rsg",
      "object": "bank_account_verification",
      "bank_account_number": "10000000000057",
      "bank_ifsc_code": "HDFC0000123",
      "name_as_per_bank": "Anil Reddy",
      "force_penny_drop": false,
      "force_penny_drop_amount": 1.23,
      "status": "success",
      "message": "Transaction Successful",
      "last_verified_at": "2022-03-15",
      "metadata": {
        "key_1": "DD",
        "key_2": "XOF"
      },
      "merchant_reference_id": "1000057",
      "created_at": 1647328219,
      "is_sandbox": true
    }
  }
}