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 more about our webhooks.

Available Webhook Events

The table below lists the various webhook events triggered when executing a create transfer API.

Webhook Events	Description
transfers.created	Triggered when Create Transfer API call is successfully made.
transfers.updated	Triggered when the transfer undergoes a status change.
payments.created	Triggered when the credit wallet received the money.

Sample Payload

Transfers Created

Triggered when Create Transfer API call is successfully made.

{
  "id": "evl_H9hT12AV9HKxolYX5OhiMncHR",
  "object": "event",
  "name": "transfers.created",
  "is_sandbox": true,
  "data": {
    "object": {
      "id": "tr_IpmLfkjF0lEAuLg5k4ewTP56M",
      "object": "transfer",
      "type": "wallet",
      "amount": 1,
      "debit_account_id": "va_dMeCnE9BJe33hcxfx630hxLgI",
      "credit_account_id": "va_i27q2fQ1bit02M949yUH4UlvI",
      "status": "initiated",
      "currency_code": "inr",
      "payment_remark": "Lego Death Star",
      "paid_to": "3636365881434711",
      "otp_attempts": 0,
      "metadata": {
        "key_1": "DD",
        "key_2": "XOF"
      },
      "merchant_reference_id": "1002372",
      "transacted_at": 1663670499,
      "is_sandbox": true,
      "created_at": 1663670499
    }
  }
}

Transfers Updated

Triggered when the transfer undergoes a status change.

{
  "id": "evl_H9hT12AV9HKxolYX5OhiMncHR",
  "object": "event",
  "name": "transfers.created",
  "is_sandbox": true,
  "data": {
    "object": {
      "id": "tr_IpmLfkjF0lEAuLg5k4ewTP56M",
      "object": "transfer",
      "type": "wallet",
      "amount": 1,
      "debit_account_id": "va_dMeCnE9BJe33hcxfx630hxLgI",
      "credit_account_id": "va_i27q2fQ1bit02M949yUH4UlvI",
      "status": "success",
      "currency_code": "inr",
      "payment_remark": "Lego Death Star",
      "paid_to": "3636365881434711",
      "otp_attempts": 0,
      "metadata": {
        "key_1": "DD",
        "key_2": "XOF"
      },
      "merchant_reference_id": "1002372",
      "transacted_at": 1663670499,
      "is_sandbox": true,
      "created_at": 1663670499
    }
  }
}

Payments Created

Triggered when the credit wallet received the money.

{
  "id": "evl_2LMGd0fn7mon8yPG1ZozKukgk",
  "object": "event",
  "name": "payments.created",
  "is_sandbox": true,
  "data": {
    "object": {
      "id": "tx_CYBq087qHFNdE1x0OLlRYQtxg",
      "object": "payment",
      "account_id": "va_i27q2fQ1bit02M949yUH4UlvI",
      "amount": 1,
      "currency": "inr",
      "transacted_at": 1663670499,
      "bank_reference_number": null,
      "status": "success",
      "remitter_bank_account_number": "36363651397412035",
      "remitter_bank_ifsc_code": "YESB0CMSNOC",
      "remitter_full_name": "Anil Reddy",
      "remitter_note": "Lego Death Star",
      "remitter_vpa_handle": null,
      "paid_mode": "wallet",
      "paid_to": "3636365881434711",
      "transaction_reference_id": null,
      "remark": "Lego Death Star",
      "merchant_reference_id": "1002372",
      "expiry_in_minutes": null,
      "mandate_id": null,
      "metadata": {
        "key_1": "DD",
        "key_2": "XOF"
      },
      "is_sandbox": true,
      "created_at": 1663670499
    }
  }
}