Razorpay API (all endpoints)
Razorpay payment gateway APIs for accepting payments, managing orders, processing refunds, payouts, and subscriptions. All amounts are in the smallest…
Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.
Overview
Razorpay payment gateway APIs for accepting payments, managing orders, processing refunds, payouts, and subscriptions. All amounts are in the smallest currency sub-unit (e.g. paise for INR). Supports 180+ payment methods including UPI, cards, netbanking, wallets, and EMI.
Endpoints 136
Orders
- GETFetch all orders
/ordersRetrieve a paginated list of orders. Maximum 100 records per call. - POSTCreate an order
/ordersCreate an order before initiating a payment. The returned order_id must be passed to Razorpay Checkout. An order can have multiple payment attempts but only… - GETFetch order by ID
/orders/:idRetrieve the full details and current status of a specific order. - PATCHUpdate an order
/orders/:idUpdate the notes field of an existing order. Only notes can be modified after creation. - GETFetch payments for an order
/orders/:id/paymentsRetrieve all authorized and failed payment attempts made against a specific order.
Payments
- GETFetch all payments
/paymentsRetrieve a paginated list of payments. Maximum 100 per call. - GETFetch payment by ID
/payments/:idRetrieve full details and current status of a specific payment. Always re-fetch before acting — status can change. - PATCHUpdate a payment
/payments/:idUpdate the notes field of a payment. Only notes can be modified. - POSTCapture a payment
/payments/:id/captureCapture an authorized payment to collect funds. Must be called within the capture window (default 5 days). Amount must exactly equal authorized amount unless…
Refunds
- POSTCreate a refund
/payments/:id/refundInitiate a full or partial refund for a captured payment. Use speed=normal (default, 5-7 business days) or speed=optimum for instant refund (falls back to… - GETFetch refunds for a payment
/payments/:payment_id/refundsRetrieve all refunds issued against a specific payment. - GETFetch a specific refund for a payment
/payments/:payment_id/refunds/:refund_idRetrieve a specific refund by its ID scoped to a particular payment. - GETFetch all refunds
/refundsRetrieve a paginated list of all refunds across payments. Maximum 100 per call. - GETFetch refund by ID
/refunds/:idRetrieve full details and current status of a specific refund. - PATCHUpdate a refund
/refunds/:idUpdate the notes field of a refund. Only notes can be modified.
Payment Downtimes
- GETFetch all payment downtimes
/payments/downtimesRetrieve current and upcoming payment method downtimes for cards, netbanking, and UPI. Use to surface degraded methods in checkout UI. - GETFetch payment downtime by ID
/payments/downtimes/:idRetrieve details of a specific payment downtime event.
Payment Links
- GETFetch all payment links
/payment_linksRetrieve all payment links. Filter by payment_id or reference_id to narrow results. - POSTCreate a payment link
/payment_linksCreate a shareable payment link to collect payments via SMS and email. Supports standard links (all payment methods) and UPI-only links (set upi_link=true).… - GETFetch payment link by ID
/payment_links/:idRetrieve full details of a specific payment link. - PATCHUpdate a payment link
/payment_links/:idUpdate an existing payment link. Updates are only allowed when the link is in 'created' or 'partially_paid' status. - POSTCancel a payment link
/payment_links/:id/cancelCancel a payment link. Only links in 'created' status can be cancelled. Paid, partially paid, and already expired links cannot be cancelled. - POSTSend or resend payment link notification
/payment_links/:id/notify_by/:mediumSend or resend a payment link notification to the customer via SMS or email.
QR Codes
- GETFetch all QR codes
/payments/qr_codesRetrieve all QR codes. Filter by customer_id or payment_id. - POSTCreate a QR code
/payments/qr_codesCreate a UPI QR code for accepting digital payments. Only upi_qr type is supported (on-demand feature; requires merchant activation). single_use QR codes… - GETFetch QR code by ID
/payments/qr_codes/:idRetrieve details of a specific QR code including payment counts and status. - PATCHUpdate a QR code
/payments/qr_codes/:idUpdate the notes field of a QR code. Only notes can be modified after creation. - POSTClose a QR code
/payments/qr_codes/:id/closeDeactivate a QR code to stop accepting new payments. Once closed, the QR code cannot be reopened. - GETFetch payments for a QR code
/payments/qr_codes/:id/paymentsRetrieve all payments made against a specific QR code.
Customers
- GETFetch all customers
/customersRetrieve a paginated list of all customers. Maximum 100 per call. - POSTCreate a customer
/customersCreate a customer profile. The combination of email and contact must be unique per customer. Customer profiles enable saved card tokens, faster checkout, and… - GETFetch customer by ID
/customers/:idRetrieve full details of a specific customer. - PUTUpdate a customer
/customers/:idUpdate a customer's name, email, or contact. The combination of email and contact must remain unique. Contact number must contain at least 8 digits.
Documents
- POSTUpload a document
/documentsUpload a file to Razorpay. Returns a document ID that can be used in dispute evidence submissions. Supports JPEG, PNG, and PDF formats. - GETFetch document info
/documents/:idRetrieve metadata for an uploaded document (name, MIME type, size, purpose). Document IDs are exactly 14 alphanumeric characters. - POSTFetch document content
/documents/:id/contentRetrieve the binary content of a previously uploaded document. Returns the raw file bytes.
Settlements
- GETFetch all settlements
/settlementsRetrieve a paginated list of settlements. Each settlement represents a batch transfer to your bank account. Maximum 100 per call. - GETFetch settlement by ID
/settlements/:idRetrieve details of a specific settlement transaction. - GETFetch settlement reconciliation report
/settlements/recon/combined?year=2024&month=4Retrieve a detailed transaction-level reconciliation report for a given month (or day). Each record maps a payment, refund, transfer, or adjustment to its…
Instant Settlements
- GETFetch all instant settlements
/settlements/ondemandRetrieve a list of all on-demand instant settlements. Use expand[]=ondemand_payouts to include individual payout records inline. - POSTCreate an instant settlement
/settlements/ondemandRequest an on-demand (instant) settlement of your available Razorpay balance to your bank account. Fees apply. Use settle_full_balance=true to settle… - GETFetch instant settlement by ID
/settlements/ondemand/:idRetrieve details of a specific on-demand instant settlement. Use expand[]=ondemand_payouts to include payout records.
Disputes
- GETFetch all disputes
/disputesRetrieve a list of all payment disputes. Use expand[]=payment or expand[]=transaction.settlement for additional context. - GETFetch dispute by ID
/disputes/:idRetrieve full details of a specific dispute including submitted evidence. - POSTAccept a dispute
/disputes/:id/acceptAccept a dispute, acknowledging it as lost. This is irreversible — the dispute status changes to 'lost' and the disputed amount is deducted from your balance.… - PATCHContest a dispute
/disputes/:id/contestSubmit evidence to challenge a dispute. Use action=draft to save without submitting, or action=submit to send for bank review (triggers…
Items
- GETList all items
/itemsRetrieve all catalog items. Supports pagination. - POSTCreate an item
/itemsCreate a reusable catalog item. Items can be referenced in invoice line_items by item_id, which auto-fills price and description. Each item is merchant-scoped. - GETFetch an item
/items/:idGet details of a specific catalog item. - DELETEDelete an item
/items/:idPermanently delete a catalog item. Deleted items cannot be recovered. - PATCHUpdate an item
/items/:idUpdate the name, description, amount, currency, or active status of an item.
Invoices
- GETList all invoices
/invoicesRetrieve a list of invoices. Filter by type, status, customer, payment, or subscription. Returns up to 100 per call. - POSTCreate an invoice
/invoicesCreate an invoice or payment page. Set type='invoice' for a formal invoice or type='link' for a simple payment page. The invoice is created in draft state;… - GETFetch an invoice
/invoices/:idGet full details of a specific invoice including status, line items, and payment information. - DELETEDelete a draft invoice
/invoices/:idPermanently delete a draft invoice. Only invoices in draft status can be deleted. - PATCHUpdate an invoice
/invoices/:idUpdate invoice fields. Updatable fields depend on current status: draft=all fields; issued=partial_payment, receipt, comment, terms, notes, expire_by;… - POSTIssue an invoice
/invoices/:id/issueTransition a draft invoice to issued status, sending a notification to the customer with the payment link. Once issued, line items cannot be changed. - POSTCancel an invoice
/invoices/:id/cancelCancel a draft or issued invoice. Cancelled invoices cannot be paid and cannot be reinstated. - POSTSend invoice notification
/invoices/:id/notify_by/:mediumSend or resend the invoice payment link to the customer via SMS or email.
Plans
- GETList all plans
/plansRetrieve all billing plans. Supports pagination. - POSTCreate a plan
/plansDefine a recurring billing plan with a fixed period, interval, and amount. Plans are reusable across multiple subscriptions. Once created, plan details cannot… - GETFetch a plan
/plans/:idGet details of a specific billing plan.
Subscriptions
- GETList all subscriptions
/subscriptionsRetrieve all subscriptions. Filter by plan_id or status. Returns up to 100 per call. - POSTCreate a subscription
/subscriptionsSubscribe a customer to a plan. Returns a short_url that the customer MUST open to authorize the payment mandate (UPI Autopay, NACH, or card-on-file). The… - GETFetch a subscription
/subscriptions/:idGet current status and full details of a subscription. - PATCHUpdate a subscription
/subscriptions/:idUpdate plan, quantity, or schedule future changes for a subscription. Use schedule_change_at='now' for immediate effect (creates a new billing cycle) or… - POSTCancel a subscription
/subscriptions/:id/cancelCancel an active or authenticated subscription. Use cancel_at_cycle_end=1 to continue service until the end of the current cycle before cancelling. - POSTPause a subscription
/subscriptions/:id/pausePause an active subscription. No charges will be attempted while paused. Resume with POST /subscriptions/{id}/resume. - POSTResume a paused subscription
/subscriptions/:id/resumeResume a paused subscription. Charging resumes on the next scheduled cycle. - GETFetch scheduled changes
/subscriptions/:id/retrieve_scheduled_changesRetrieve any pending plan or quantity changes scheduled for the next billing cycle. - POSTCancel scheduled changes
/subscriptions/:id/cancel_scheduled_changesCancel any pending plan or quantity changes that were scheduled for the next billing cycle. - DELETEDelete an offer from a subscription
/subscriptions/:sub_id/:offer_idRemove an applied offer/coupon from a subscription. The offer will no longer apply from the next billing cycle.
Linked Accounts
- POSTCreate a Linked Account
/v2/accountsCreate a sub-merchant (Linked Account) under a Route marketplace. The account type must be 'route'. Email and business_type cannot be changed after creation.… - GETFetch a Linked Account
/v2/accounts/:account_idRetrieve the details of a Linked Account by its ID. Also used in Partners API to fetch sub-merchant account details (authentication: OAuth access_token). - PATCHUpdate a Linked Account
/v2/accounts/:account_idUpdate mutable fields of a Linked Account. email and business_type cannot be changed after creation. - POSTCreate a Stakeholder
/v2/accounts/:account_id/stakeholdersAdd a business owner or director to a Linked Account. Only one stakeholder is allowed per Route Linked Account. PAN 4th character must be 'P' (individual PAN). - PATCHUpdate a Stakeholder
/v2/accounts/:account_id/stakeholders/:stakeholder_idUpdate stakeholder information for a Linked Account. - POSTRequest Route product configuration
/v2/accounts/:account_id/productsRequest activation of the Route product for a Linked Account. Submits the account for review and KYC. Activation progresses: requested → under_review →… - GETFetch product configuration
/v2/accounts/:account_id/products/:product_idRetrieve the current product configuration and activation status for a Linked Account. - PATCHUpdate product configuration
/v2/accounts/:account_id/products/:product_idUpdate settlement details or other configuration for a Route product on a Linked Account.
Transfers
- GETFetch transfers for a payment
/payments/:id/transfersRetrieve all transfers created from a specific payment. - POSTCreate transfers from a payment
/payments/:id/transfersSplit a captured payment to one or more Linked Accounts. Amount is deducted from the payment and transferred to the recipient. INR only, minimum ₹100 per… - GETList transfers
/transfersRetrieve a paginated list of transfers. Filter by recipient_settlement_id to fetch transfers included in a specific settlement. Use… - POSTCreate a direct transfer
/transfersCreate an on-demand direct transfer from the merchant account to a Linked Account. Requires the Direct Transfer feature to be enabled on the account. Supports… - GETFetch a transfer
/transfers/:idRetrieve details of a specific transfer by ID. - PATCHModify settlement hold on a transfer
/transfers/:idPut a transfer's settlement on hold or release an existing hold. Use on_hold=true to hold settlement, on_hold=false to release. on_hold_until sets a future… - GETList reversals for a transfer
/transfers/:id/reversalsRetrieve all reversals for a specific transfer. - POSTReverse a transfer
/transfers/:id/reversalsMove funds from a Linked Account back to the merchant. Partial reversals are supported. Multiple reversals per transfer are allowed as long as the total…
Virtual Accounts
- GETList Virtual Accounts
/virtual_accountsRetrieve a paginated list of virtual accounts with optional filters. - POSTCreate a Virtual Account
/virtual_accountsCreate a virtual bank account (and optionally a VPA) for accepting NEFT/RTGS/IMPS/UPI payments. Set amount_expected=0 to accept any amount. Auto-closes after… - GETFetch a Virtual Account
/virtual_accounts/:idRetrieve details of a specific virtual account. - PATCHUpdate a Virtual Account
/virtual_accounts/:idUpdate the amount_expected or close_by timestamp on an active virtual account. - POSTClose a Virtual Account
/virtual_accounts/:id/closeManually close an active virtual account so it no longer accepts payments. - GETFetch payments for a Virtual Account
/virtual_accounts/:id/paymentsRetrieve all payments received by a virtual account. Returns Payment objects. - POSTAdd a VPA receiver to a Virtual Account
/virtual_accounts/:id/receiversAdd a UPI VPA receiver to an existing virtual account (Smart Collect 2.0). Requires the VPA receiver feature to be enabled on the merchant account. - POSTAdd an allowed payer (TPV)
/virtual_accounts/:va_id/allowed_payersWhitelist a specific payer bank account or VPA for a virtual account (Smart Collect with Third Party Validation). Only whitelisted payers can successfully pay… - DELETEDelete an allowed payer (TPV)
/virtual_accounts/:va_id/allowed_payers/:idRemove a payer from the whitelist of a virtual account (Smart Collect TPV). The payer will no longer be able to make payments to this virtual account. - GETFetch bank transfer details for a payment
/payments/:id/bank_transferRetrieve the BankTransfer entity associated with a payment received via a Virtual Account. Contains the UTR number, payer bank account details, and transfer…
Bills
- POSTCreate a bill
/billsCreate a digital bill/receipt for a customer. Supports retail, food & beverage, events, and ecommerce use cases. Used for Razorpay Billme digital receipts. - DELETEDelete a bill
/bills/:bill_idDelete a digital bill/receipt. - PATCHUpdate a bill
/bills/:bill_idUpdate an existing digital bill. Can update customer details, line items, receipt summary, and other fields.
Partner Accounts
- DELETEDelete (suspend) a sub-merchant account
/v2/accounts/:account_idSuspend a sub-merchant account created via Partners API. Sets account status to 'suspended' and returns suspended_at timestamp. Authentication: OAuth…
Partner Stakeholders
- GETFetch all stakeholders for an account
/v2/accounts/:account_id/stakeholdersRetrieve all stakeholders associated with a sub-merchant account. Partners API only — Route allows only 1 stakeholder per account. Authentication: OAuth…
Partner Documents
- GETFetch KYC documents for a sub-merchant account
/v2/accounts/:account_id/documentsRetrieve all KYC documents uploaded for a sub-merchant account. Authentication: OAuth access_token. - POSTUpload KYC documents for a sub-merchant account
/v2/accounts/:account_id/documentsUpload KYC documents for business identity and address verification. Multipart form upload. JPG/PNG max 4MB, PDF max 2MB. Authentication: OAuth access_token. - GETFetch KYC documents for a stakeholder
/v2/accounts/:account_id/stakeholders/:stakeholder_id/documentsRetrieve all KYC documents uploaded for a specific stakeholder. Authentication: OAuth access_token. - POSTUpload KYC documents for a stakeholder
/v2/accounts/:account_id/stakeholders/:stakeholder_id/documentsUpload identity and address verification documents for a stakeholder. Supports PAN, Aadhaar (front/back), passport (front/back), voter ID (front/back).…
Partner Webhooks
- GETList webhooks for a sub-merchant
/v2/accounts/:account_id/webhooksRetrieve all webhooks configured for a sub-merchant account. Authentication: OAuth access_token. - POSTCreate a webhook for a sub-merchant
/v2/accounts/:account_id/webhooksCreate a webhook to receive events for a sub-merchant account. Maximum 30 webhooks per account. Authentication: OAuth access_token. - GETFetch a webhook by ID
/v2/accounts/:account_id/webhooks/:webhook_idRetrieve details of a specific webhook for a sub-merchant account. Authentication: OAuth access_token. - DELETEDelete a webhook
/v2/accounts/:account_id/webhooks/:webhook_idDelete a webhook for a sub-merchant account. Returns empty array on success. Authentication: OAuth access_token. - PATCHUpdate a webhook
/v2/accounts/:account_id/webhooks/:webhook_idUpdate webhook URL, events, secret, or active status for a sub-merchant account. Authentication: OAuth access_token.
X Contacts
- GETList contacts
/contactsFilter and list all contacts. Supports filtering by name, email, phone number, reference ID, and active status. - POSTCreate a contact
/contactsCreate a payout recipient contact. Returns existing contact if all identifying fields (name, email, contact, type) match an existing record. - GETFetch a contact
/contacts/:contact_idFetch details of a specific contact by its ID. - PATCHUpdate or activate/deactivate a contact
/contacts/:contact_idUpdate contact details or activate/deactivate a contact. Set active: false to deactivate.
X Fund Accounts
- GETList fund accounts
/fund_accountsList fund accounts linked to contacts. Filter by contact ID and/or account type. - POSTCreate a fund account
/fund_accountsCreate a bank account, VPA, card, or wallet (Amazon Pay) fund account linked to a contact. Fund accounts are immutable after creation. Returns existing record… - GETFetch a fund account
/fund_accounts/:fund_account_idFetch details of a specific fund account by its ID. - PATCHActivate or deactivate a fund account
/fund_accounts/:fund_account_idActivate or deactivate a fund account. Fund account details are immutable — only the active status can be changed.
X Account Validation
- GETList fund account validations
/fund_accounts/validationsList all fund account validation records, optionally filtered by date range. - POSTValidate a bank account or VPA
/fund_accounts/validationsThree validation methods: (1) penny drop for bank accounts — sends Re.1 to verify; (2) penny drop for VPA — sends Re.1 to UPI address; (3) reverse penny drop… - GETFetch a fund account validation
/fund_accounts/validations/:validation_idFetch details of a specific fund account validation by its ID.
X Payouts
- GETList payouts
/payouts?account_number=stringList payouts for a given RazorpayX account. Filter by contact, fund account, date range, or status. - POSTCreate a payout
/payoutsDisburse funds via NEFT, RTGS, IMPS, UPI, or card. Supports standard payouts (fund_account_id), composite payouts (contact + fund account inline), card… - GETFetch a payout
/payouts/:payout_idFetch details of a specific payout by its ID. - POSTCancel a queued payout
/payouts/:payout_id/cancelOnly payouts in 'queued' status can be cancelled. - POSTApprove a payout (workflow enabled)
/payouts/:payout_id/approveRequires Payouts Approval workflow enabled and Technology Partner status with OAuth. - POSTReject a payout (workflow enabled)
/payouts/:payout_id/rejectRequires Payouts Approval workflow enabled and Technology Partner status with OAuth.
X Banking Balances
- GETFetch RazorpayX banking balances
/banking_balancesFetch balance details for RazorpayX current accounts or RazorpayX Lite accounts.
X Payout Links
- GETList payout links
/payout-linksList all payout links. Filter by contact ID, status, or date range. - POSTCreate a payout link
/payout-linksSend a payout link to a contact when fund account details are unavailable. expire_by must be at least 15 minutes in the future. - GETFetch a payout link
/payout-links/:payout_link_idFetch details of a specific payout link by its ID. - POSTCancel a payout link
/payout-links/:payout_link_id/cancelCancel a payout link that is in issued or pending state.
X Transactions
- GETList transactions for a RazorpayX account
/transactions?account_number=stringReturns all transaction records (credits and debits) for a given RazorpayX account. Use account_number from Dashboard → My Account & Settings → Banking →… - GETFetch a transaction by ID
/transactions/:transaction_idFetch details of a specific transaction from a RazorpayX account by its ID.
API details
- Base URL
https://api.razorpay.com/v1- Authentication
- HTTP Basic authentication (username and password)
OAuth 2.0 (authorization code, client credentials flows) with 1 scope - Operations
- 136 operations on 93 pathsGET 63POST 47PATCH 18DELETE 7PUT 1
- Main resources
- Subscriptions 10Virtual Accounts 10Invoices 8Linked Accounts 8Transfers 8Payment Links 6QR Codes 6Refunds 6X Payouts 6Items 5
- Response formats
application/jsonapplication/octet-stream- Description format
- OpenAPI 3.0.0, API version
1.0.0 - Links
- Documentation · OpenAPI document · Terms of service · Support
- Listed from
- Razorpay's published OpenAPI description
How to test the Razorpay API (all endpoints) in Swastik Codes
- Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
- Fork it into your workspaceChoose a workspace. You get your own copy of the Razorpay API (all endpoints) collection, without the publisher's secrets.
- Add your credentialsThis API uses HTTP Basic authentication (username and password). Add yours in the collection's variables or an environment; the requests already reference it.
- Send a requestPick an endpoint, for example “Fetch all orders” (GET /orders), and press Send. Check the response, add tests and run the whole collection with the runner.
Frequently asked questions
What is the Razorpay API (all endpoints)?
Razorpay payment gateway APIs for accepting payments, managing orders, processing refunds, payouts, and subscriptions. All amounts are in the smallest… It is listed under Finance & banking and has 136 endpoints.
Who publishes the Razorpay API (all endpoints)?
It is listed from Razorpay's public API description (an OpenAPI document), not published by Razorpay on Swastik Codes. Anyone who controls razorpay.com can claim the profile by adding a DNS TXT record.
What is the base URL of the Razorpay API (all endpoints)?
Requests go to https://api.razorpay.com/v1. Endpoint paths are added to this base URL.
How do I authenticate with the Razorpay API (all endpoints)?
It accepts 2 methods: HTTP Basic authentication (username and password); OAuth 2.0 (authorization code, client credentials flows) with 1 scope.
How many endpoints does the Razorpay API (all endpoints) have?
136 operations on 93 paths (63 GET, 47 POST, 18 PATCH, 7 DELETE, 1 PUT). The largest groups are Subscriptions, Virtual Accounts, Invoices, Linked Accounts.
Is forking the Razorpay API (all endpoints) free?
Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.