> For the complete documentation index, see [llms.txt](https://docs.swipez.in/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.swipez.in/webhook.md).

# Webhooks

Webhooks are events that notify you about the payment status. All Payment integrations should establish a webhook to listen to transaction events, like status changes on payments. Webhooks are HTTP callbacks that receive notification messages for events.

Webhooks help you receive automatic updates and are significant for completing the integration with Swipez. Webhooks are triggered with a request from your side, for example, when a payment fails or success. Swipez notifies you once we get updates from the bank about the payment status.

| Parameters            | Description                              |
| --------------------- | ---------------------------------------- |
| transaction\_id       | Swipez transaction id                    |
| reference\_no         | Reference number provided  by Merchant   |
| status                | Transaction status "success" or "failed" |
| date                  | Transaction date time                    |
| bank\_ref\_no         | Bank reference number                    |
| mode                  | Payment mode eg. Credit card, UPI        |
| amount                | Transaction amount                       |
| billing\_name         | Payee name                               |
| billing\_email        | Payee email id                           |
| billing\_mobile       | Payee mobile number                      |
| billing\_address      | Payee address                            |
| billing\_city         | Payee city                               |
| billing\_state        | Payee state                              |
| billing\_postal\_code | Payee pincode                            |
| udf1                  | Extra parameter provided by merchant     |
| udf2                  | Extra parameter provided by merchant     |
| udf3                  | Extra parameter provided by merchant     |
| udf4                  | Extra parameter provided by merchant     |
| udf5                  | Extra parameter provided by merchant     |