Razorpay
Payment gateway and financial services platform for businesses in India
Verdict
Common use cases
- Generate payment links during sales calls
- Cancel invoices for disputed charges
- Create orders for checkout flows
- Check transaction status in support tickets
- Pull payout reports for month-end close
Integration
- Vendor
- Razorpay
- Category
- other
- Auth
- API_KEY
- Tools
- 42
- Composio slug
razorpay
Tools
- Cancel Invoice
Tool to cancel an existing Razorpay invoice. Use this when you need to cancel an invoice that has been issued but not yet paid. Only invoices in 'issued' status can be cancelled.
- Cancel Payment Link
Tool to cancel a specific payment link. Use when you need to cancel an active payment link before it expires. The payment link cannot be used after cancellation.
- Create an Invoice
Tool to create an invoice for billing customers. Use when you need to generate an invoice with customer details and line items. You can create a blank invoice in draft state, update it later, and issue it when ready.
- Create an Order
Tool to create a Razorpay order with specified amount and currency. Use when you need to initiate a payment order before collecting payment from a customer. Amount and currency are mandatory parameters; receipt and notes are optional for in
- Create Contact
Tool to create a contact for payouts in RazorpayX. Use when you need to add a new contact (employee, vendor, or customer) for making payouts.
- Create Customer
Tool to create a new customer in Razorpay. Use when you need to register a customer for recurring payments or saved cards. Returns a customer_id that can be used for future transactions.
- Create Item
Tool to create an item that can be used in Razorpay invoices. Use when you need to create a new product or service entry for invoicing purposes.
- Create Payment Link
Tool to create a payment link for collecting payments via a shareable URL. Use when you need to generate a payment link for a customer to complete payment online.
- Delete Invoicedestructive
Tool to delete an invoice in Razorpay. Use when you need to permanently remove an invoice from the system. Note: Only invoices in 'draft' status can be deleted. Invoices in other statuses (issued, paid, cancelled) cannot be deleted.
- Delete itemdestructive
Tool to delete an existing item from Razorpay. Use when you need to permanently remove an item from the system. Items can only be deleted if they are not associated with any invoices.
- Fetch All Customers
Tool to retrieve a paginated list of all customers from Razorpay. Use when you need to get customer details for multiple customers or iterate through the customer base.
- Fetch All Invoices
Tool to fetch all invoices with pagination and filtering support. Use when you need to retrieve a list of invoices, optionally filtered by payment ID, customer ID, receipt, or date range.
- Fetch All Orders
Tool to retrieve a paginated list of all orders from Razorpay. Use when you need to fetch multiple orders, filter by date range, receipt, or authorization status.
- Fetch All Payment Links
Tool to fetch all payment links with pagination and filtering support. Use when you need to retrieve a list of payment links, optionally filtered by payment ID, reference ID, or date range.
- Fetch All Payments
Tool to retrieve all payments from your Razorpay account with pagination and time filtering support. Use when you need to list payments, audit transactions, or analyze payment history. Returns payments in descending order by creation time (
- Fetch All Refunds
Tool to retrieve all refunds created by you using the Razorpay API. Use when you need to list refunds, track refund status, or analyze refund history with pagination support.
- Fetch all refunds for a payment
Tool to retrieve all refunds for a specific payment using the Razorpay API. Use when you need to check refund status, track refund history, or list all refunds associated with a particular payment.
- Fetch a Payment Link
Tool to retrieve details of a specific payment link by its ID. Use when you need to check the status, amount, customer details, or other attributes of an existing payment link.
- Fetch Invoice by ID
Tool to fetch a specific invoice by its ID from Razorpay. Use when you need to retrieve complete details of an invoice including customer information, line items, amounts, and payment status.
- Fetch Order by ID
Tool to fetch details of a specific Razorpay order using its order ID. Use when you need to retrieve order information, check order status, or verify payment details.
- Fetch payments by order
Tool to fetch all payments made for a particular order. Use when you need to retrieve payment details associated with a specific order ID.
- Get Contact
Tool to retrieve details of a specific contact by ID in RazorpayX. Use when you need to fetch information about an existing contact including their name, email, contact details, and metadata.
- Get Fund Account
Tool to retrieve details of a specific fund account by its ID. Use when you need to fetch fund account information including associated contact, account type, and payment details.
- Get Item
Tool to retrieve complete details of a specific Razorpay item by its ID. Use when you need to fetch information about an item including its name, description, amount, tax details, and other metadata.
- Get Settlement Reconciliation Report
Tool to fetch settlement reconciliation report for a specific date or month from Razorpay. Use when you need to retrieve detailed settlement transaction data for accounting and reconciliation purposes.
- Get Transfer Reversals
Tool to fetch all reversals for a specific transfer using the Razorpay Route API. Use when you need to check reversal status, track reversal history, or list all reversals associated with a particular transfer.
- Issue an Invoice
Tool to issue a draft Razorpay invoice to send it to the customer. Use when you need to issue an invoice that has been created in draft status. Only invoices in 'draft' status can be issued.
- List Customer Tokens
Tool to retrieve all tokens (saved payment methods) for a customer. Use when you need to fetch the list of saved payment methods associated with a specific customer ID.
- List Disputes
Tool to retrieve a list of all disputes with pagination support. Use when you need to view chargebacks, fraud claims, or other payment disputes. Supports filtering by date range and pagination for efficient retrieval of dispute records.
- List Fund Accounts
Tool to retrieve a list of all fund accounts from RazorpayX with pagination support. Use when you need to fetch payout destinations, view beneficiary accounts, or manage fund account records. Supports filtering by contact and account type f
- List Fund Validations
Tool to fetch all fund account validation transactions from RazorpayX with pagination support. Use when you need to retrieve validation records, check account verification status, or monitor validation transactions.
- List Items
Tool to retrieve a list of all items from Razorpay with pagination support. Use when you need to fetch invoice items, view available products, or manage item catalog. Supports filtering by active status and date range for efficient retrieva
- List Payment Downtimes
Tool to fetch all active payment method downtimes from Razorpay. Use when you need to check the current status of payment methods and identify any ongoing or scheduled downtimes.
- Notify Payment Link
Tool to send or resend notification for a payment link via SMS or email. Use when you need to notify a customer about a payment link.
- Retrieve Customer
Tool to retrieve details of a specific customer by their ID. Use when you need to fetch customer information including name, email, contact details, and custom notes.
- Send/Resend Invoice Notification
Tool to send or resend an invoice notification via email or SMS. Use when you need to notify customers about an invoice through their preferred communication channel.
- Update Contact
Tool to update an existing contact's details in RazorpayX. Use when you need to modify contact information such as name, email, phone number, type, reference ID, or notes.
- Update Customer
Tool to update an existing customer's details in Razorpay. Use when you need to modify customer information such as name, email, or contact number.
- Update Invoice
Tool to update an existing draft invoice in Razorpay. Use when you need to modify invoice details such as customer information, line items, description, notes, or other fields. Only invoices in draft state can be updated.
- Update Item
Tool to update an existing item's details in Razorpay. Use when you need to modify the name, description, or amount of an item. Only the fields provided in the request will be updated; other fields remain unchanged.
- Update Order
Tool to update an existing order in Razorpay. Use when you need to modify the notes field of an order to store or update additional metadata.
- Update payment link
Tool to update an existing payment link in Razorpay. Use when you need to modify payment link details such as reference ID, expiry time, partial payment settings, notes, or reminder preferences.
Setup
Setup guide
- 11. In Switchy, open your workspace settings and navigate to Integrations. 2. Find Razorpay in the MCP directory and click Connect. 3. Log into your Razorpay account at dashboard.razorpay.com and go to Settings → API Keys. 4. Generate a new key pair (or use an existing one) and copy both the Key ID and Key Secret. 5. Paste the Key ID and Key Secret into the Switchy connection form and click Authorize. 6. Switchy will verify the credentials and confirm the connection. 7. Open any Space and type '@Razorpay create a payment link for $50' to test — the MCP should respond with a shareable URL. 8. If you see an error, double-check that your API keys have the correct permissions (orders, invoices, payment links) enabled in the Razorpay dashboard.
What teammates see: by default, memories from Razorpay are scoped to the Space (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.
Works well with
Top models
Compatibility data appears once enough Spaces have used this MCP together with a given model.
How Switchy teams use it
Starter prompts
Create Client Payment Link
@Razorpay create a payment link for $250 with description 'Consulting retainer - March 2025' and send me the URLOpen in a Space →
Draft Invoice for Review
@Razorpay create a draft invoice for customer ID cust_abc123 with two line items: 'Web design' for $1500 and 'Hosting setup' for $200Open in a Space →
Check Order Status
@Razorpay get the status and details for order ID order_xyz789 and tell me if payment was capturedOpen in a Space →
Cancel Unused Payment Link
@Razorpay cancel payment link ID plink_def456 and confirm it's no longer accessibleOpen in a Space →
Add New Payout Contact
@Razorpay create a contact named 'Acme Supplies' with email acme@example.com and phone +919876543210 for vendor payoutsOpen in a Space →
Example outputs
Illustrative - representative of the model's voice and quality, not literal recordings.
@razorpay show me all payment links created in the last 7 days and their current status
Here's an illustrative summary of recent payment links: 5 links created in the past week. 2 are paid (₹45,000 total), 2 are active and awaiting payment (₹32,500 outstanding), and 1 expired without payment. The active links are for Invoice #INV-2024-089 (₹18,000, expires in 3 days) and Consulting Services (₹14,500, expires tomorrow). This example shows typical data you'd see when querying payment link status.
This example demonstrates read-only access to payment link data. Requires API key with read permissions for payment links. The MCP returns structured data about link status, amounts, and expiration — useful for tracking outstanding payments without logging into the Razorpay dashboard.
@razorpay create a payment link for ₹25,000 with description 'Q1 Consulting Invoice' that expires in 48 hours
Payment link created successfully. Link ID: plink_NX8kM2pQrZ7vAa. Shareable URL: https://rzp.io/l/NX8kM2pQrZ (illustrative). Amount: ₹25,000. Description: Q1 Consulting Invoice. Expires: 48 hours from now. The link accepts UPI, cards, netbanking, and wallets. You can share this URL with your customer via email or messaging. This example shows the typical response structure when creating a new payment link.
This write operation creates a live payment link in your Razorpay account. Requires API key with write permissions. Once created, the link is immediately active and can collect real payments. Be cautious with amount and expiration settings — cancelled links cannot be reused, only replaced with new ones.
@razorpay review all unpaid invoices over 30 days old and draft a summary email for our finance team highlighting overdue amounts by customer
Based on illustrative invoice data: 4 invoices are overdue by 30+ days, totaling ₹1,23,500. Breakdown by customer: Acme Corp (2 invoices, ₹68,000, oldest is 47 days overdue), Beta Solutions (1 invoice, ₹35,500, 38 days overdue), Gamma Industries (1 invoice, ₹20,000, 33 days overdue). Draft email: 'Team, we have ₹1.23L in receivables overdue 30+ days across 3 customers. Acme Corp represents 55% of this aging balance. Recommend immediate follow-up on their oldest invoice (47 days). Full details attached.' This synthesis combines invoice queries with AI-generated communication.
This example pairs Razorpay's invoice listing tools with AI reasoning to identify patterns and draft communications. The MCP fetches invoice data; the AI analyzes aging and composes the summary. Useful for automating collections workflows, but verify amounts before sending external communications — invoice status can change between query and action.
Use-case deep-dives
When Razorpay beats Stripe for Indian SaaS billing
A 10-person SaaS startup selling to Indian SMBs needs to invoice 200 customers monthly, handle failed payments, and reconcile in Tally. Razorpay's MCP is the right call here because the invoice and payment link tools let your support team regenerate links or cancel invoices directly from Switchy without context-switching to the dashboard. The 42 tools cover the full billing lifecycle—create customer, create invoice, issue it, cancel if needed. The threshold: if you're billing internationally or need multi-currency beyond INR/USD basics, Razorpay's tooling gets clunky and you'll want Stripe's MCP instead. For India-first revenue under $2M ARR, this MCP turns your billing ops into a shared-context workflow where finance and support see the same invoice state in real time.
Using Razorpay MCP for vendor payout visibility
A 6-person marketplace team pays 50 vendors weekly via RazorpayX and spends 4 hours reconciling payout status across Slack threads and spreadsheets. The Razorpay MCP's contact and payout tools let your ops lead query payout status, create new vendor contacts, and flag failed transfers without leaving Switchy. The win is speed: instead of screenshotting the RazorpayX dashboard, your team references live payout data in the same thread where vendors ask 'where's my money?' The catch: if your payout volume exceeds 500/week, the MCP's per-tool latency adds up and you're better off building a custom dashboard. For mid-volume marketplaces doing 50-200 payouts weekly, this MCP collapses the reconciliation loop from hours to minutes.
When Razorpay MCP speeds up failed-payment triage
A 4-person support team at a subscription app fields 30 'my payment failed' tickets daily. Each ticket requires checking order status, regenerating a payment link, or canceling a stale invoice—tasks that currently mean toggling between Zendesk and Razorpay's dashboard. The Razorpay MCP puts those tools in Switchy: your support rep pastes the order ID, queries status, and creates a fresh payment link in one thread. The customer gets a working link in 90 seconds instead of 10 minutes. The boundary: if your payment failure rate is under 2%, the MCP is overkill—just train support to use the dashboard. Above 5% failure rate or 20+ tickets/day, this MCP turns payment triage from a context-switch tax into a one-screen workflow.
Frequently asked
What can Switchy do with the Razorpay MCP?
Switchy can create and manage payment orders, invoices, and payment links through Razorpay. The MCP handles 42 operations including customer creation, invoice cancellation, contact management for payouts, and item catalog setup. You can automate billing workflows, generate shareable payment URLs, and manage the full payment lifecycle without leaving your workspace.
What Razorpay credentials does the MCP need?
You need a Razorpay API key pair (key ID and secret) from your Razorpay dashboard. Generate these under Settings → API Keys. The MCP uses API_KEY authentication, not OAuth, so there's no scope selection—the key grants access to all operations your Razorpay account permits. Store the secret securely; Razorpay won't show it again after creation.
Can the MCP process actual payments or refunds?
No. The MCP creates orders, invoices, and payment links—the setup work before a customer pays. Actual payment processing happens when your customer completes checkout through Razorpay's hosted pages or your integration. The MCP can cancel unpaid invoices and links, but refunds for completed payments require Razorpay's dashboard or a separate refund API call.
How is this different from using Razorpay's dashboard directly?
The MCP lets you script repetitive billing tasks inside Switchy's AI workspace instead of clicking through Razorpay's UI. If you're generating dozens of invoices, creating payment links in bulk, or syncing customer data from another tool, the MCP is faster. For one-off payments or viewing transaction history, the dashboard is simpler.
Who on the team should connect Razorpay to Switchy?
Whoever manages your Razorpay account and has access to API keys—typically finance or ops. That person controls which Razorpay environment (test or live) Switchy uses. Once connected, any Switchy user can trigger payment workflows you've built, but they can't see the raw API credentials or change Razorpay settings outside Switchy.