API ReferenceIntegrationsKnowledge Base

RazorpayX APIs

Below is a high-level diagrammatic overview of the payouts process in RazorpayX.

Post sign up, account activation and KYC verification you are eligible to make payouts. Complete the following three steps to create your first payout via APIs:

  1. Create a Contact
  2. Add a Fund Account to a contact
  3. Create a Payout

It is assumed that you have already added funds to your business account. This action cannot be performed via APIs and has to be done before you can make a payout. Click here to know more about how to add funds to your business account.

Refer to the detailed contact, fund account, payout and transaction API documentation to learn more about all the available API actions for these entities.

Refer to the webhook section to learn about our webhooks.

API Gateway URL#

The Razorpay API Gateway URL is https://api.razorpay.com/v1. You need to include this before each API endpoint to make API calls.

API Authorization#

All Razorpay APIs are authorized using Basic Authorization. Basic authorization requires the following:


Generate API Key#


  • If you are an existing Razorpay merchant, you can use your existing API key with RazorpayX as well.
  • If you are a new user, then you will have to generate a Key ID and a Key Secret to make API calls.

The API key is a combination of <YOUR_KEY_ID> and <YOUR_KEY_SECRET> and is required to make any API request to Razorpay. You also have to implement the API key in your code as part of your integration process.

To generate your key ID and key secret:

  1. Log into your RazorpayX Dashboard, click Menu and click Account Settings.

  2. Click API Keys and Webhooks.

  3. Click Generate Key.

  4. The Key ID and Key Secret are generated for your business account. Click Download Key Details to download the key ID and key secret details.

Watch the short animation below for more information.

After generating the keys from the Dashboard, download and save them securely. Razorpay does not store <YOUR_KEY_SECRET>. This is visible only at the time of key generation. If you have already generated your API key and do not remember it, you will need to re-generate the keys from the Dashboard and replace it in your integration code.

Terminologies Used#

Business Account
Business account is your unique account on the RazorpayX platform to which you can transfer funds. Funds are available in your business account so you can make payouts 24/7 365.
A contact is an entity to whom payouts are made. Contacts have certain identification properties such as name, email ID and phone number. Financial transactions can be made to a contact by adding a fund account(s) to the contact.
Fund Account
A fund account is an entity to which payouts can be made. A fund account can be of multiple types. Currently, RazorpayX supports three types of fund accounts:
  • bank_account: Make payouts to a contact's bank account via bank transfer using one of the available Payout Modes such as NEFT or IMPS.
  • cards: Make payouts directly to a contact's card via a bank transfer using one of the available Payout Modes such as NEFT or IMPS.
  • vpa (Virtual Payment Address): Make payouts to a contact's VPA via a UPI transfer.
Inflow of funds to your business account, payouts to a contact's fund account and reversals are all recorded as transactions against your business account. You can view transactions from the Dashboard or fetch details using the Transactions APIs.