> ## Documentation Index
> Fetch the complete documentation index at: https://wabis.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Razorpay

> Send WhatsApp messages when a Razorpay payment succeeds, fails, or is refunded.

## What is this?

The **Razorpay** integration turns payment events into WhatsApp messages. When a payment is captured, fails, or is refunded, Razorpay tells the platform and an automation sends the template you chose — for example *Payment received, thank you!* or *Your payment failed, tap to retry*.

Razorpay doesn't let apps create webhooks for you. So instead of connecting with a login, the platform gives you a **Webhook URL** and a **Webhook secret** that you paste into your Razorpay dashboard once.

## What can I do here?

* Send a WhatsApp template for each payment event
* Get a ready-made automation that routes each Razorpay event to the right template
* See every request Razorpay sent, including duplicates and failures
* Have every delivery checked against Razorpay's signature

## How to use it

**1. Open the Razorpay page**

Go to **Integrations**, click **Razorpay**, then **Connect**. Enter your **Razorpay key ID** (`rzp_live_…`) and **key secret** — find them in Razorpay under **Settings → API keys**. They let the platform create payment links and take store payments.

**2. Choose your messages**

Pick a WhatsApp template for each event you want to message about:

| Event | When it happens |
| - | - |
| **Payment authorized** | The bank authorized the payment |
| **Payment captured** | The payment was collected |
| **Payment failed** | The payment didn't go through |
| **Order paid** | A Razorpay order is fully paid |
| **Refund processed** | A refund was completed |

Leave an event empty to send nothing for it.

**3. Set up and activate**

Click **Set up and activate**. The automation is created and you're shown your **Webhook URL** and **Webhook secret**.

**4. Add the webhook in Razorpay**

In your Razorpay dashboard, open **Settings → Webhooks**, add a webhook using the URL and secret, and enable the events you chose, plus `payment_link.paid`, `payment_link.expired` and `payment_link.cancelled` so payment links settle automatically. Use the copy buttons to avoid typos.

> [!WARNING]
>
> Treat the webhook secret like a password. You can view it again from the connection's details if you need it.

## Things to know

* **The customer's phone number** comes from the payment details Razorpay sends. Payments without a phone number can't be messaged.
* **Nothing arrives until you add the webhook in Razorpay.** The automation is created straight away, but Razorpay only sends events once its dashboard has the URL and secret.
* **One account, used everywhere.** Once saved, the account is offered in the storefront's **Online payment** list, in **Request payment** on a contact and in the [Send Payment](https://wabis.mintlify.site/workspace/automation/steps/send-messages.md#send-payment) step. Payments appear on the contact's [Payments](https://wabis.mintlify.site/workspace/contacts/payments.md) tab.
* **Older webhooks need three more events.** If you set up the Razorpay webhook before payment links existed, tick `payment_link.paid`, `payment_link.expired` and `payment_link.cancelled` in Razorpay. The connection page lists the events to enable.
* **Payments made another way** (QR code, hosted page, other checkout) aren't recorded unless they come through a payment link made here.
* **Repeats are ignored.** If Razorpay retries the same event, the customer isn't messaged twice.

## Troubleshooting / Technical Notes

* **No messages are sent.** Check the webhook is added in Razorpay with the exact URL and secret, that the events are ticked, and that a template is chosen for each event.
* **Requests appear as failed.** Open the connection's **Activity** tab and select the request to see the error and its raw body. A wrong secret is a common cause.
* **A customer wasn't messaged.** The payment needs a phone number, and the template must be approved.
* **You changed the automation.** You can edit the flow in the builder any time, including which template each event uses.

## Related docs

* [Integrations Overview](https://wabis.mintlify.site/workspace/integrations/overview.md)
* [Payments](https://wabis.mintlify.site/workspace/contacts/payments.md)
* [Webhooks](https://wabis.mintlify.site/workspace/integrations/webhooks.md)
* [Templates](https://wabis.mintlify.site/workspace/whatsapp/templates.md)
* [Automation Overview](https://wabis.mintlify.site/workspace/automation/overview.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.