> ## Documentation Index
> Fetch the complete documentation index at: https://www.cashfree.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Cashfree Webhooks

> Learn what Cashfree webhooks are, when to use them, and where to find product-specific event and payload documentation across all products.

A webhook is an HTTP `POST` callback that Cashfree sends to a URL you register when a specific event occurs in your account, such as a payment confirmation, a payout reversal, or a KYC session outcome. Every webhook is signed with HMAC-SHA256 using your client secret. Signature verification is required before you process any payload.

## When to use webhooks

Use webhooks for any outcome that is asynchronous (not known immediately when the API returns):

* A bank confirmation arrives after a payment is initiated.
* A beneficiary bank reverses a payout.
* A Video KYC session is reviewed by an auditor.
* A wallet credit completes after a fund transfer.

<Note>
  For business-critical flows, combine webhooks with an API poll as a fallback. Webhooks are near real time but are not guaranteed to arrive within your application timeout.
</Note>

## Webhooks by product

Each product area has its own webhook entry point, linked below.

<CardGroup cols={2}>
  <Card title="Payment Gateway webhooks" icon="credit-card" href="/docs/api-reference/payments/latest/webhooks/overview">
    Setup, event references, signature verification, and troubleshooting for Payment Gateway webhooks.
  </Card>

  <Card title="Payouts webhooks" icon="chart-line" href="/docs/api-reference/payouts/webhooks-overview">
    Payouts V2 and V1 webhook references, Cashgram, and product documentation in one place.
  </Card>

  <Card title="Secure ID webhooks" icon="shield" href="/docs/api-reference/vrs/webhooks-overview">
    Video KYC, BAV V2, reverse penny drop, DigiLocker, KYC links, e-sign, and signature verification.
  </Card>

  <Card title="PPI webhooks" icon="wallet" href="/docs/api-reference/prepaid-payment-instruments/webhooks-overview">
    Wallet credit and PPI webhook verification and wallet management webhook references.
  </Card>

  <Card title="Partner platform webhooks" icon="handshake" href="/docs/api-reference/platforms/latest/webhooks-overview">
    Merchant onboarding and other platform webhook entry points in the Partners APIs.
  </Card>
</CardGroup>

The following table lists example webhook use cases across Cashfree's product areas.

| Product area                              | Example use cases                                                                                                                       |
| ----------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
| **Payment Gateway**                       | Confirm order payment status, trigger order fulfilment, handle refund updates, process chargeback alerts, sync settlement notifications |
| **Payouts**                               | Detect failed or reversed transfers, trigger low-balance alerts, confirm bulk transfer outcomes, track credit confirmations             |
| **Secure ID (Video KYC)**                 | Track KYC session progress, trigger post-approval onboarding, flag failed pre-checks                                                    |
| **Secure ID (Bank account verification)** | Confirm asynchronous verification outcomes, handle rejected or failed checks                                                            |
| **Secure ID (Reverse penny drop)**        | Notify when verification succeeds, expires, or fails                                                                                    |
| **Prepaid Payment Instruments (PPI)**     | Confirm wallet credit events and drive balance updates                                                                                  |

## What you need to do

Complete these steps to receive and process Cashfree webhooks reliably.

<Steps>
  <Step title="Choose products and events">
    Identify which products you integrate with and which events to handle. Use [Events by product](/docs/api-reference/webhooks/events-by-product) as a starting point.
  </Step>

  <Step title="Implement an HTTPS endpoint">
    Build a publicly reachable HTTPS URL that accepts `POST` requests, reads the raw body for signature verification, and returns `200` quickly.
  </Step>

  <Step title="Register the URL in the Merchant Dashboard">
    Open **Add Webhook Endpoint** under the product's developer settings, enter your URL, and click **Test** to verify it. Then select a retry policy and the events to subscribe to, and save. See [Configure webhook endpoints](/docs/api-reference/webhooks/configure-endpoints) for dashboard paths.
  </Step>

  <Step title="Verify signatures on every request">
    Reject any payload that fails cryptographic verification. See [Payloads and signature verification](/docs/api-reference/webhooks/payloads-and-signatures) for the algorithm per product family.
  </Step>

  <Step title="Acknowledge immediately and process asynchronously">
    Return `200` after signature verification, then process the event in a background worker. Non-`200` responses trigger retries.
  </Step>

  <Step title="Handle retries and idempotency">
    Webhooks follow at-least-once delivery. Store processed event IDs to prevent duplicate side effects. See [Reliability and operations](/docs/api-reference/webhooks/reliability-and-operations).
  </Step>

  <Step title="Test, then go live">
    Exercise flows in sandbox and confirm payloads against the product reference before enabling in production.
  </Step>
</Steps>

## In this section

This section contains the following guides for implementing and operating Cashfree webhooks.

| Guide                                                                                  | Purpose                                                                   |
| -------------------------------------------------------------------------------------- | ------------------------------------------------------------------------- |
| [Configure webhook endpoints](/docs/api-reference/webhooks/configure-endpoints)             | Merchant Dashboard paths and how to add and test a URL per product        |
| [Events by product](/docs/api-reference/webhooks/events-by-product)                         | Summary event lists per product area                                      |
| [Payloads and signature verification](/docs/api-reference/webhooks/payloads-and-signatures) | Body shape, sample payloads, and verification algorithms                  |
| [Reliability and operations](/docs/api-reference/webhooks/reliability-and-operations)       | Retries, idempotency, best practices, IP allow lists, migration, and FAQs |