How to Connect Razorpay Payment Processor

This document explains how to connect Razorpay with SureCart so you can start accepting payments from your customers.

Razorpay is a popular payment processor in India that supports payments via cards, net banking, wallets, and UPI. SureCart connects to Razorpay using a secure authorization flow, so no manual API keys or webhook configuration is required.

Requirements

Before getting started, make sure you have:

• WordPress admin access
• SureCart installed and activated
• At least one published product
• An active Razorpay account
• Access to SureCart → Settings → Payment Processors

If you plan to sell subscription products:

• Recurring Payments (Subscriptions) enabled in your Razorpay account
  

How the Razorpay Connection Works

SureCart connects to Razorpay using an authorization-based connection.

During setup:

• You choose whether to connect in Test Mode or Live Mode
• You are redirected to Razorpay to authenticate
• You authorize SureCart to access your Razorpay account
• Once authorized, the processor is automatically enabled in SureCart

No API keys or webhook setup is required.

How to Connect Razorpay in Test Mode

Follow these steps to connect Razorpay in Test Mode:

• Go to your WordPress dashboard.
• Navigate to SureCart → Settings → Payment Processors.
• Locate Razorpay in the list of available processors and click it.

This will open the Razorpay processor page inside app.surecart.com.

Step 1: Start the Connection

Note: Make sure you are already logged into your Razorpay account in the same browser before clicking Connect.  Otherwise, the authorization flow may fail after login.

• Click the Connect button.
• From the dropdown, select Test Mode.

Step 2: Authorize the Connection in Razorpay

• You will be redirected to Razorpay.
• Log in to your Razorpay account if prompted.
• Review the permissions requested by SureCart.
• Click Authorize to approve the connection.

Step 3: Confirm the Connection

After authorization:

• You will be redirected back to app.surecart.com
• A success message will confirm the connection
• The Razorpay account status will show as Enabled
• The connection mode will be marked as Test

At this point, Razorpay is ready to be used for test transactions.

How to Connect Razorpay in Live Mode

Once you have verified everything in Test Mode, you can connect Razorpay in Live Mode.

The process is the same, with one important difference: you must select Live Mode.

• Go to SureCart → Settings → Payment Processors → Razorpay
• Click Connect
• Select Live Mode
• Log in to Razorpay (if required)
• Click Authorize
  

After authorization, you’ll be redirected back to SureCart, and the Razorpay account will appear as Enabled in Live Mode.

Notes, Limitations, and Edge Cases

• Razorpay requires the checkout currency to be supported. Currently, Razorpay requires Indian Rupee (INR). If another currency is used, Razorpay will not appear as a payment option at checkout.
• Razorpay availability depends on the customer’s billing country. The checkout must allow India or other Razorpay-supported countries.
• Razorpay requires a customer phone number to process payments. When Razorpay is enabled, SureCart automatically adds a Phone field to the checkout form. No manual checkout form changes are required.
• Subscription payments require Recurring Payments to be enabled in the Razorpay account.
  • Depending on the account, this feature may already be available or require a manual request to Razorpay Support.
  • If not enabled, subscription checkouts may fail even if Razorpay is connected successfully.
• Currently, the Razorpay OAuth connection requires the merchant to be logged into Razorpay in the same browser before connecting it to SureCart.  

If the merchant logs in during the OAuth flow, the redirect back to SureCart may fail. This issue is being investigated by the Razorpay team.

• Test Mode and Live Mode must be connected separately. Connecting one does not automatically enable the other.
  

Expected Outcome

After completing the steps in this document:

• Razorpay will be successfully connected to SureCart using a secure authorization flow.
• The Razorpay processor will appear as Enabled in SureCart.
• The active connection mode (Test or Live) will be clearly displayed.
• Razorpay will be available as a payment option at checkout when:
  • The correct mode is connected
  • The checkout currency is supported (INR)
  • The customer’s billing country is supported
  • Required checkout fields (such as phone number) are completed

FAQs