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

# Razorpay

> Read payments, orders, refunds, and settlements from Razorpay

## At a glance

* **Availability**: Experimental ([how to enable](/cloud/integrations)).
* **Auth**: Basic auth.
* **Connection**: HTTP Basic auth with `RAZORPAY_KEY_ID` as the username and `RAZORPAY_KEY_SECRET` as the password.
* **Docs**: [https://razorpay.com/docs/api/authentication/](https://razorpay.com/docs/api/authentication/)

## Credentials

Set these per environment. See [Connect an integration](/cloud/integrations).

| Variable              | Required | Description                                                                                                |
| --------------------- | -------- | ---------------------------------------------------------------------------------------------------------- |
| `RAZORPAY_KEY_ID`     | Yes      | Razorpay Key ID (rzp\_test\_.... or rzp\_live\_...) [Docs](https://razorpay.com/docs/api/authentication/). |
| `RAZORPAY_KEY_SECRET` | Yes      | Razorpay Key Secret [Docs](https://razorpay.com/docs/api/authentication/).                                 |

## Setup

1. **Sign in to the Razorpay Dashboard**: Go to [https://dashboard.razorpay.com](https://dashboard.razorpay.com). Switch to Test Mode to experiment safely - test keys are prefixed rzp\_test\_.
2. **Generate API keys**: Open Account & Settings → API Keys and generate a key pair. The Key Secret is shown only once - store it immediately.
3. **Set environment variables**: Add RAZORPAY\_KEY\_ID and RAZORPAY\_KEY\_SECRET to your .env.
4. **Verify access**: Run List Payments (Test Mode returns test transactions). Switch to Live Mode keys for production data.

* Authentication is HTTP Basic: base64(KEY\_ID:KEY\_SECRET) in the Authorization header
* Timestamps in from/to filters are Unix epoch seconds; amounts are in the smallest currency unit (paise for INR)

Provider API reference: [https://razorpay.com/docs/api/](https://razorpay.com/docs/api/)

## Tools

| Tool             | Access | Description                                              |
| ---------------- | ------ | -------------------------------------------------------- |
| List Payments    | Read   | List payments, optionally within a Unix-timestamp window |
| Get Payment      | Read   | Get details of a payment                                 |
| List Orders      | Read   | List orders                                              |
| Get Order        | Read   | Get details of an order                                  |
| List Refunds     | Read   | List refunds                                             |
| List Settlements | Read   | List settlements paid out to your bank account           |

## Example prompts

* List my Razorpay payments from the last 7 days and summarize totals by status and method.
* Show my recent Razorpay settlements with amounts and statuses.