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

# Razorpay Payouts Setup

> Configure RazorpayX credentials and cashback WhatsApp templates

<Warning>
  **Beta Feature** — Razorpay Payouts is currently in beta. Contact [arjun@referbro.com](mailto:arjun@referbro.com) to enable it for your store. The Settings section and Cashback Payout Link template stay hidden until it is enabled.
</Warning>

## 1. Save RazorpayX Credentials

After the feature is enabled, open **Apps → Referbro → Settings** and fill in **Razorpay Payout Credentials**:

| Field              | Description                                                              |
| :----------------- | :----------------------------------------------------------------------- |
| **Key ID**         | Razorpay API Key ID from the API Keys section of your Razorpay Dashboard |
| **Key Secret**     | Razorpay API Key Secret (stored encrypted)                               |
| **Account Number** | RazorpayX current account number used to send payouts                    |
| **Mode**           | `Test` for development, `Live` for production payouts                    |

Click **Save Credentials**. Automated cashback payouts will not run until credentials are saved.

<Important>
  Use **Test** mode with RazorpayX test keys until you have verified a full payout. Switch to **Live** only when you are ready to send real money.
</Important>

## 2. Use a Cashback Campaign

In **Campaign Configuration**, set **Referrer Reward Type** to **Cashback** and set the reward amount. Automated payouts apply only to cashback campaigns.

## 3. Configure Cashback WhatsApp Templates

With Razorpay Payouts enabled, WhatsApp Settings shows an extra template slot.

### Cashback Payout Link Template

Sent when the payout link is created — before any money moves. The referrer must open this link to claim the cashback.

| Placeholder         | Replaced With                    |
| :------------------ | :------------------------------- |
| `{{REFERRER_NAME}}` | Referrer's name                  |
| `{{PAYOUT_AMOUNT}}` | Cashback amount (e.g. `₹150.00`) |
| `{{PAYOUT_LINK}}`   | Razorpay claim URL               |

Copy a ready-to-use example from the [Template Library](/docs/features/whatsapp/template-library#9-cashback-payout-link).

### Reward Notification Template

Sent after Razorpay marks the payout as processed.

For cashback payouts, use:

| Placeholder         | Replaced With                      |
| :------------------ | :--------------------------------- |
| `{{REFERRER_NAME}}` | Referrer's name                    |
| `{{PAYOUT_AMOUNT}}` | Cashback amount (e.g. `₹150.00`)   |
| `{{UTR}}`           | Bank UTR once Razorpay provides it |

See [Reward Notification](/docs/features/whatsapp/template-library#7-reward-notification) for gift card, store credit, and discount-code variants of this template.

<Tip>
  You don't need to configure all templates at once. For automated cashback, start with **Cashback Payout Link** — the payout is unused until the referrer opens it.
</Tip>

## Tracking Payouts

On **Analytics → Referral Details**, cashback rows show payout status instead of **Mark as Paid** (manual mark-as-paid is disabled while Razorpay Payouts is on).

Typical states:

* **Awaiting payout** — not yet sent to Razorpay
* **Payout issued / pending / processing** — the referrer still needs to claim, or Razorpay is transferring funds
* **Payout processed (UTR: …)** — money has been sent
* **Payout skipped / failed** — check the reason on the row (for example a missing phone number)