## Zoho Payments Documentation Index

Access the complete documentation index at:
https://www.zoho.com/in/payments/llms.txt

Use this file to discover all available documentation pages before proceeding.

# Webhooks

Webhooks are real-time notifications sent from Zoho Payments' servers to your servers when specific events occur. You can subscribe to a predefined set of events while configuring the URL to receive these notifications. This enables you to take appropriate actions swiftly, based on the events. Refer to our [API Docs](https://www.zoho.com/in/payments/api/v1/webhooks/#overview "API Docs") for request examples of the webhooks.

Zoho Payments supports the following webhooks:

*   [Payment Webhooks](#payment-webhook)
*   [Payment Link Webhooks](#payment-link-webhook)
*   [Refund Webhooks](#refund-webhook)
*   [Payout Webhooks](#payout-webhook)

## Payment Webhooks

A payment webhook is triggered when a payment is processed in Zoho Payments, notifying your system of the payment status (successful, declined, or pending). It provides details like payment ID, amount, and payment method, enabling your system to take immediate actions such as order fulfillment or customer notifications. This webhook ensures you’re always up to date with transaction statuses.

Below is a list of payment webhook events and their descriptions.

**Events**

**Description**

payment.succeeded

This event is triggered when a payment succeeds, providing details such as the payment ID, payment method, and amount paid.

payment.failed

This event is triggered when a payment fails, providing information about the failure reason, allowing you to take necessary actions to resolve the issue.  
  
Webhooks are triggered for each payment attempt while the session is active. Before acting on a `payment.failed` webhook, verify the payment session status using the Payment Session ID, as the payment may succeed in a later attempt.

* * *

## Payment Link Webhooks

A payment link webhook is triggered when a payment is made through a link in Zoho Payments, notifying your system of the payment link status (paid, cancelled, or expired). Enabling this webhook helps keep customers informed of their payment status in real-time.

Below is a list of payment link webhook events and their descriptions.

**Events**

**Description**

payment\_link.paid

This event is triggered when a payment link is successfully paid, providing the payment ID, amount, and the date and time of the payment.

payment\_link.cancelled

This event is triggered when a payment link is manually cancelled, providing the link details with the status marked as cancelled.

payment\_link.expired

This event is triggered when a payment link expires without payment, providing the link details with the status marked as expired.

* * *

## Refund Webhooks

A refund webhook is triggered when a refund is initiated or processed. It notifies your system about the refund status (successful, failed, or pending), including details like the original payment ID and refunded amount. Subscribing to this webhook helps automate actions like updating customer accounts or notifying customers about their refund status in real-time.

Below is a list of refund webhook events and their descriptions.

**Events**

**Description**

refund.succeeded

This event is triggered when a refund is successful, providing details such as the refund amount, payment ID, and the reason for the refund.

refund.failed

This event is triggered when a refund fails, providing the failure reason.

* * *

## Payout Webhooks

A payout webhook is triggered when a payout transaction is processed in Zoho Payments, notifying your system of the payout status (initiated, completed, or failed). It provides key details like payout ID, amount, and transaction summary, enabling your system to track payout progress and take appropriate actions.

Below is a list of payout webhook events and their descriptions.

**Events**

**Description**

payout.initiated

This event is triggered when a payout is successfully initiated, providing details like payout ID, amount, and transaction summary.

payout.paid

This event occurs when a payout is successfully completed, with details such as payout ID, amount, and transaction summary.

payout.failed

This event occurs when a payout fails for various reasons, including payout ID, amount, transaction summary, and the failure reason.