Razorpay
In one line: Let your UnleashX agent look up payments and orders, create payment links and orders, issue refunds, and manage subscriptions in your Razorpay account.
1. Overview
Razorpay is a payments platform widely used across India to accept card, UPI, netbanking, and wallet payments. It also handles orders, refunds, shareable payment links, recurring subscriptions and plans, and settlements (the money paid out to your bank account). Once you connect Razorpay to UnleashX, your agent can act on your live payment data. It can tell a caller whether their payment went through, generate and send a payment link mid-conversation, refund a charge, create or cancel a subscription, or pull up settlement reports — without you logging into the Razorpay Dashboard. Connecting Razorpay to UnleashX is ideal for support and sales workflows: the agent answers “did my payment succeed?”, collects money on the spot via a link, and handles billing changes, all using your real Razorpay account. Sensitive details such as full card numbers, emails, and phone numbers are automatically redacted in responses.2. What you’ll need
- A Razorpay account with Dashboard access (dashboard.razorpay.com).
- Permission to view Settings → API Keys (typically an Admin / Owner role).
- Your API Key ID (
key_id) and API Key Secret (key_secret). - A decision on Test mode vs Live mode — each has its own separate key pair.
If you don’t have admin access, ask a Razorpay account admin to generate an API key pair for you. Connecting only needs the
key_id and key_secret.3. Get your credentials
Razorpay MCP authenticates with your API Key ID and API Key Secret. These are combined into an HTTP Basic auth credential (key_id:key_secret) and sent with every request.
1
Open API Keys in the Dashboard
Log in to the Razorpay Dashboard and go to Settings → API Keys. Choose Test mode or Live mode at the top first — keys differ per mode.
2
Generate a key pair
Click Generate Key (or Generate Test Key). Razorpay creates a Key ID (starts with
rzp_test_ or rzp_live_) and a Key Secret.3
Copy the Key Secret immediately
Permissions this key grants UnleashX
Razorpay API keys are account-wide and are not scoped to specific permissions. Use a Test mode key while building, and switch to Live mode only when you’re ready to move real money.
4. Connect on UnleashX
1
Open your agent
Sign in at tryunleashx.com and open the agent you want to give Razorpay access to.
2
Go to Data Connectors
Open Data Connectors and find Razorpay in the list.
3
Connect
Click Connect / Add / Configure, then paste your Key ID and Key Secret (sent as the
key-id and key-secret credentials). Authenticate once.4
Confirm success
When the keys are valid, the status changes to a Connected badge. Your agent can now use the Razorpay tools below.
Use Razorpay in a Workflow
Once connected, you can add Razorpay to any automation from the Workflows builder. Its triggers and tools appear in the Apps panel, marked with an MCP badge.1
Add a trigger or action node
Open Workflows → New Workflow. On the canvas, click + Add Trigger (or the + below any node) to add a step.
2
Pick Razorpay from the Apps panel
In the Paths panel, open the Apps tab and select Razorpay. Use the search box if you have many connectors.
3
Choose a trigger or tool
Pick the trigger or action you want. Configure its fields — required fields are marked with a red asterisk (*).
4
Add or select your account
Under Selected account, choose an already-connected account, or click Add Account to connect one now.
5
Save and test
Fill in the remaining fields and click Save. Use Test to verify the step, then toggle Publish when the workflow is ready.
The steps are the same for every connector. For the full workflow builder guide, see Using MCP in Workflows.
5. Available tools
This server exposes 32 tools. Tools marked ⚠️ are guarded — destructive actions (refunds, cancellations, on-demand settlements) require you to confirm before they run.Payments
Refunds
Orders
Customers
Payment links
Settlements
Subscriptions
Plans
6. Example usage
“Did paymentpay_ NfX29kLm go through? If it did, refund it in full.”
→ Runs Fetch Payment to check status, then Create Refund (asks you to confirm before issuing the refund).
“Create a ₹1,499 payment link for this customer and text it to them.”
→ Runs Create Payment Link (amount in paise, i.e. 149900) and returns the shareable link with SMS/email notification enabled.
7. Permissions & data access
UnleashX can:- Read payments, orders, refunds, settlements, customers, subscriptions, and plans.
- Create orders, payment links, customers, subscriptions, and plans.
- Capture payments, issue refunds, and create on-demand settlements (with confirmation).
- Update, pause, resume, and cancel subscriptions, and cancel payment links (cancellations require confirmation).
- See full card numbers, full email addresses, or full phone numbers — these are automatically masked/redacted in responses.
- Change your Razorpay account settings, bank details, webhooks, or KYC.
- Move money outside the actions above (e.g. it cannot transfer funds to arbitrary accounts).
key_id/key_secret no longer work anywhere.
8. Troubleshooting
For general connector issues, see /mcp/integrations.
9. Frequently asked questions
Is my payment data stored by UnleashX? No. UnleashX calls the Razorpay API on demand for each request. Card numbers, emails, and phone numbers are also redacted in the data the agent sees. Will the agent accidentally refund or cancel something? No. Refunds, cancellations, and on-demand settlements are guarded — they only run after you explicitly confirm, so they can’t fire by accident. Can I test before going live? Yes. Generate a Test mode key pair, connect that, and exercise the workflows with test data. Switch to a Live mode key only when you’re ready to handle real money. How do I rotate my keys? In Settings → API Keys, regenerate the key pair, then reconnect Razorpay in UnleashX with the newkey_id/key_secret. The old secret stops working immediately.