A Step-by-Step Guide: How to Integrate Razorpay with Your WooCommerce Website

By WovLab Team | March 17, 2026 | 16 min read

Why Razorpay is the Go-To Payment Gateway for Indian WooCommerce Stores

In the vibrant and rapidly expanding Indian e-commerce landscape, selecting the right payment gateway is paramount for the success of any online store. For businesses leveraging the power of WooCommerce, the decision to integrate Razorpay with your WooCommerce website often stands out as the most strategic choice. Razorpay has firmly established itself as India's leading payment solution, primarily due to its comprehensive feature set, robust security, and deep understanding of the local market's nuances.

Unlike many international payment gateways, Razorpay offers an unparalleled array of payment methods specifically tailored for Indian consumers. This includes everything from UPI (Google Pay, PhonePe, Paytm, etc.), NetBanking across hundreds of banks, major credit and debit cards (Visa, Mastercard, RuPay, Amex, Diners), popular digital wallets, and even PayLater options like Simpl and OlaMoney Postpaid. This diversity is crucial, as Indian customers often prefer specific local payment methods, and offering them choice significantly reduces cart abandonment rates. Data from Razorpay indicates that businesses integrating a wide range of payment options see up to a 10-15% increase in conversion rates.

Beyond payment diversity, Razorpay boasts an intuitive dashboard for merchants, real-time analytics, and a powerful suite of developer tools that make integration seamless. Its competitive transaction fees, transparent pricing structure, and dedicated local customer support further solidify its position. For WovLab, an Indian digital agency, recommending Razorpay is a no-brainer for our WooCommerce clients looking to optimize their payment processing for the Indian market.

Key Insight: Razorpay's strength lies in its hyper-localization for the Indian market, offering an unmatched array of payment methods, competitive pricing, and robust security that directly translates to higher conversion rates and reduced operational overhead for WooCommerce store owners.

The security architecture of Razorpay adheres to the highest PCI DSS Level 1 standards, ensuring that all transactions are encrypted and customer data is protected. This is non-negotiable for building trust with your customer base. Furthermore, Razorpay supports various business models, from marketplaces to subscriptions, making it a versatile choice for almost any WooCommerce store. This blend of features makes integrating Razorpay with your WooCommerce website not just a convenience, but a strategic advantage.

Prerequisites: What You'll Need Before You Start the Integration

Before you dive into the technical process to integrate Razorpay with WooCommerce, ensuring you have all the necessary prerequisites in place will save you significant time and prevent potential roadblocks. Think of this as your pre-flight checklist – meticulous preparation ensures a smooth and successful launch of your payment gateway.

Here’s what you absolutely must have ready:

1. An Active WooCommerce Store: This might seem obvious, but ensure your WooCommerce installation is fully operational, updated to the latest stable version, and ready to accept orders. Your product catalog should be populated, and basic store settings configured.
2. A Verified Razorpay Merchant Account: You need more than just a personal account. Register for a Razorpay merchant account on their official website. This involves a KYC (Know Your Customer) process, where you'll need to submit business documents like PAN, GSTIN, bank account details, and business registration certificates. Ensure your account is fully activated and approved to accept live payments.
3. Razorpay API Keys: Once your merchant account is verified, you'll gain access to your API keys – specifically, the Key ID and Key Secret. These are crucial credentials that link your WooCommerce store to your Razorpay account.
   • To find these, log into your Razorpay Dashboard, navigate to Settings > API Keys.
   • It's highly recommended to generate a new set of keys specifically for your WooCommerce integration for enhanced security.
   • Keep these keys confidential. Never share them publicly or embed them directly in client-side code.
4. SSL Certificate (HTTPS): Your website MUST have an active SSL certificate installed and properly configured, meaning your website address should start with https://. Payment gateways, including Razorpay, will not function securely on non-HTTPS sites. This is a fundamental requirement for PCI DSS compliance and protecting customer data.
5. Administrator Access to WordPress: You'll need full administrator privileges to your WordPress dashboard to install plugins, configure WooCommerce settings, and manage payments.
6. Basic WordPress & WooCommerce Administration Knowledge: While this guide is step-by-step, a fundamental understanding of how to navigate the WordPress backend and WooCommerce settings will be beneficial.
7. Website Backup: Before making any significant changes to your website, especially involving critical functionalities like payment gateways, always perform a full backup of your website files and database. This provides a safety net in case anything goes wrong during the integration process.

Having these elements squared away beforehand will make the integration process smoother and faster, allowing you to focus on the technical steps without interruption. WovLab always advises clients to complete these foundational steps meticulously.

The 5-Step Process to Install and Configure Razorpay on WooCommerce

Now that your prerequisites are met, let's proceed with the precise steps to install and configure Razorpay on your WooCommerce website. This process is straightforward, but attention to detail is key to a flawless integration.

Here’s the expert-guided 5-step process:

1. Step 1: Install the Razorpay WooCommerce Plugin

   The first step is to get the official Razorpay plugin for WooCommerce. This plugin acts as the bridge between your store and the Razorpay payment gateway.

   • Log in to your WordPress admin dashboard.
   • Navigate to Plugins > Add New.
   • In the search bar, type "Razorpay for WooCommerce" or "Razorpay Payment Gateway".
   • Locate the official plugin, usually titled "Razorpay for WooCommerce" by Razorpay, and click Install Now.
   • Once installed, click Activate to enable the plugin on your site.

   This action integrates the necessary code and functions into your WooCommerce ecosystem, preparing it for payment processing.

2. Step 2: Navigate to WooCommerce Payment Settings

   With the plugin activated, you now need to access its configuration options within WooCommerce.

   • From your WordPress dashboard, go to WooCommerce > Settings.
   • Click on the Payments tab.
   • You should now see "Razorpay" listed among your available payment gateways.

   If you don't see Razorpay listed, ensure the plugin is activated correctly. You might need to refresh the page or clear any caching plugins you might be using.

3. Step 3: Enable and Configure Razorpay Gateway

   It's time to switch on Razorpay and input your critical account details.

   • Next to "Razorpay", toggle the switch to On to enable it.
   • Click on Manage (or "Setup" depending on the plugin version) next to Razorpay to access its detailed settings.
   • You'll be presented with several fields:
     • Enable/Disable: Ensure this checkbox is ticked.
     • Title: This is what customers see on the checkout page (e.g., "Razorpay - Credit Card/Debit Card/NetBanking/UPI").
     • Description: A brief message displayed under the title (e.g., "Pay securely via Credit/Debit Card, NetBanking, UPI, and Wallets.").
     • Key ID: Enter your Razorpay Key ID obtained from your Razorpay dashboard.
     • Key Secret: Enter your Razorpay Key Secret. Double-check these for accuracy.
     • Payment Action: Choose "Authorize and Capture" for immediate payment capture or "Authorize" for manual capture later (useful for certain business models).
     • Payment Page Display: Select "Default" or "Modal" (Modal is the standard, cleaner overlay experience).
     • Payment Theme: You can often customize the look and feel of the Razorpay checkout modal here.

   Crucial Note: Always ensure you are entering the correct API keys for the specific mode you intend to use (Test or Live). Using live keys in test mode, or vice versa, will lead to errors.

4. Step 4: Configure Webhooks for Seamless Status Updates

   Webhooks are vital for Razorpay to communicate transaction status updates back to your WooCommerce store (e.g., successful payment, refund, failure). Without them, your order statuses might not update correctly.

   • While still on the Razorpay settings page in WooCommerce, locate the Webhook URL. Copy this URL. It typically looks like https://yourdomain.com/wc-api/razorpay/.
   • Log into your Razorpay Dashboard.
   • Navigate to Settings > Webhooks.
   • Click Add New Webhook.
   • Paste the copied Webhook URL into the "Webhook URL" field.
   • Set the "Secret" field. You can generate a random strong secret or use one provided by the WooCommerce plugin if available. Ensure this secret matches the one in your WooCommerce Razorpay settings if a corresponding field exists. If not, simply generating a secret on Razorpay is sufficient.
   • Select the active events. For standard e-commerce, at a minimum, select:
     • payment.authorized
     • payment.captured
     • refund.processed
     • payment.failed

     Selecting more relevant events is generally beneficial for comprehensive order management.

   • Click Create Webhook.

   This setup ensures that your WooCommerce store receives real-time updates from Razorpay, maintaining accurate order statuses and inventory levels.

5. Step 5: Save Changes and Final Review

   Once all settings are configured, save your changes.

   • Scroll to the bottom of the Razorpay settings page in WooCommerce and click Save Changes.
   • Perform a quick review of your WooCommerce checkout page. Ensure Razorpay appears as a payment option.
   • Check your Razorpay dashboard for any webhook errors immediately after creation.

   With these steps completed, your WooCommerce store is now ready to process payments via Razorpay. The next crucial step is rigorous testing.

WovLab emphasizes that each detail, especially the API keys and webhook setup, must be precise. Any discrepancies here are the most common source of integration issues when you integrate Razorpay with WooCommerce website.

Testing Your Integration: How to Run a Secure Test Transaction in Sandbox Mode

Integrating a payment gateway without thorough testing is akin to launching a rocket without pre-flight checks – highly risky. Before you ever accept live customer payments, it's absolutely critical to run test transactions using Razorpay's Sandbox (Test) mode. This allows you to verify that your integration is working flawlessly, without any financial implications.

Here’s how to conduct a secure test:

1. Switch to Test Mode in WooCommerce and Razorpay

   • WooCommerce: Go to WooCommerce > Settings > Payments > Razorpay > Manage. Ensure the "Enable Test Mode" (or similar) checkbox is ticked. Crucially, replace your Live API Key ID and Key Secret with your Test Key ID and Test Key Secret. These are found in your Razorpay dashboard under Settings > API Keys, where you can toggle between Live and Test keys.
   • Razorpay Dashboard: While your WooCommerce plugin settings are in test mode, ensure your Razorpay dashboard itself is also in "Test Mode" when verifying transactions. There's usually a toggle on the top bar of the Razorpay dashboard.

   This ensures that any transactions initiated will not involve real money and will not affect your actual balances.

2. Initiate a Test Purchase on Your WooCommerce Store

   • Visit your WooCommerce store's frontend as if you were a customer.
   • Add a product (any product) to your cart.
   • Proceed to the checkout page.
   • Fill in all necessary customer details (shipping address, contact info).
   • Select "Razorpay" as your preferred payment method.
   • Click "Place Order".

   The Razorpay checkout modal (if you selected "Modal" display) will appear, prompting for payment details.

3. Use Razorpay's Provided Test Card Details

   Razorpay provides specific test card numbers and details for various scenarios:

   Card Type	Card Number	Expiry Date	CVV	Status
   VISA	4111 1111 1111 1111	Any Future Date	111	Success
   Mastercard	5111 1111 1111 1111	Any Future Date	222	Success
   VISA (Failure)	4012 8888 8888 8888	Any Future Date	123	Failure
   Netbanking (Test Bank)	Select a Test Bank	N/A	N/A	Success/Failure Options on page

   Enter the test card details (e.g., a successful VISA card) into the Razorpay modal. For NetBanking, select a test bank and follow the prompts, which often simulate success or failure options. Complete the payment process.

4. Verify the Transaction Status

   • WooCommerce: Immediately after completing the test payment, return to your WordPress dashboard. Navigate to WooCommerce > Orders. You should see a new order created with the status "Processing" (or "Completed" if it's a virtual/downloadable product). If the status is "Pending payment" or "Failed", something is wrong.
   • Razorpay Dashboard: Log into your Razorpay Dashboard and ensure you are in "Test Mode". Navigate to Transactions or Payments. You should see the test transaction listed with a "Captured" or "Authorized" status.

   Match the order details (amount, customer name) between WooCommerce and Razorpay to confirm accuracy.

5. Test Edge Cases (Optional but Recommended)

   • Perform a failed transaction using the provided failure test card details. Verify that WooCommerce correctly marks the order as "Failed".
   • Test refund functionality: If your business requires refunds, initiate a test refund from your Razorpay dashboard and check if WooCommerce order notes reflect this.
   • Test with different payment methods (UPI, Wallets) if applicable, using Razorpay's test environments.

Expert Advice: Never skip the testing phase. A single successful test isn't enough; test multiple scenarios, including both success and failure, to ensure the robustness of your integration. This is where WovLab clients see the value of a professional setup, preventing costly errors later.

Once you are confident that all test transactions are accurately reflected in both your WooCommerce orders and Razorpay dashboard, you can switch both systems to Live Mode by replacing Test API keys with Live API keys and disabling any "Test Mode" checkboxes. This process is crucial to successfully integrate Razorpay with WooCommerce website.

Troubleshooting Common Razorpay & WooCommerce Integration Issues

Even with the most meticulous step-by-step guide, integration issues can sometimes arise. Knowing how to diagnose and resolve these common problems quickly is crucial to minimize downtime and ensure uninterrupted payment processing on your WooCommerce store. Here are some frequent issues encountered when you integrate Razorpay with WooCommerce website, along with their practical solutions.

1. Payments Not Going Through / Stuck in "Pending Payment"

• Issue: Customers complete the payment on Razorpay, but the WooCommerce order status remains "Pending payment" or "On Hold."
  • Cause 1: Incorrect API Keys. The most common culprit. If you've used test keys in live mode, or vice-versa, payments will fail or not reflect.
    Solution: Double-check that your Razorpay API Key ID and Key Secret in WooCommerce settings (WooCommerce > Settings > Payments > Razorpay) correspond to your active Razorpay dashboard mode (Live for live payments, Test for sandbox payments).
  • Cause 2: Webhook Misconfiguration. The webhook is how Razorpay communicates payment success back to WooCommerce. If it's incorrect or not firing, WooCommerce won't update the order status.
    Solution:
    1. Verify the Webhook URL in your Razorpay dashboard (Settings > Webhooks) matches the one provided in your WooCommerce Razorpay settings (https://yourdomain.com/wc-api/razorpay/).
    2. Ensure the webhook secret (if used) matches between Razorpay and WooCommerce.
    3. Check your Razorpay webhook logs for any delivery failures or errors. If there are errors, they usually indicate a problem with your server's ability to receive the webhook.
    4. Ensure the necessary webhook events (payment.captured, payment.authorized) are selected in Razorpay.
  • Cause 3: SSL Certificate Issues. An invalid or missing SSL certificate can prevent Razorpay from securely communicating with your site.
    Solution: Ensure your website is running on HTTPS and the SSL certificate is valid and not expired.

2. "Invalid Key" or "Authentication Failed" Errors

• Issue: Upon attempting payment, you receive an error message about an invalid key or authentication failure.
  • Cause: Typo in API Keys or Mode Mismatch. Your API Key ID or Key Secret might be incorrect, or you're using test keys in live mode (or vice versa).
    Solution: Carefully copy and paste your API Key ID and Key Secret directly from your Razorpay Dashboard (Settings > API Keys). Pay close attention to extra spaces. Ensure you're using the correct set of keys (Live vs. Test) corresponding to the "Enable Test Mode" setting in WooCommerce.

3. Razorpay Gateway Not Showing on Checkout

• Issue: Razorpay is installed and activated, but customers don't see it as a payment option.
  • Cause 1: Gateway Disabled. The Razorpay gateway might simply be turned off in WooCommerce settings.
    Solution: Go to WooCommerce > Settings > Payments and ensure the "Enable" checkbox next to Razorpay is ticked.
  • Cause 2: Currency Mismatch. If your WooCommerce store currency is not INR (Indian Rupees), Razorpay might not appear.
    Solution: Razorpay primarily operates in INR for Indian businesses. Ensure your WooCommerce currency (WooCommerce > Settings > General) is set to "Indian Rupee (₹)".
  • Cause 3: Plugin Conflicts. Another plugin might be interfering with WooCommerce payment gateways.
    Solution: Temporarily deactivate other plugins one by one (starting with other payment gateways or checkout-related plugins) to identify if there's a conflict.

4. Refunds Not Processing / Not Reflecting

• Issue: You initiate a refund from your WooCommerce order screen, but it fails or doesn't reflect in Razorpay.
  • Cause: Webhook Not Configured for Refunds. The webhook needs to be specifically configured to listen for refund events.
    Solution: In your Razorpay Dashboard (Settings > Webhooks), ensure that the refund.processed event (and potentially others like refund.created) is selected for your WooCommerce webhook.
  • Cause: Insufficient Balance. If initiating refunds from Razorpay dashboard itself, ensure your Razorpay account has sufficient balance.

5. White Screen of Death / Critical Error After Plugin Activation

• Issue: Your site breaks after activating the Razorpay plugin.
  • Cause: PHP Version Incompatibility or Server Resources. This can happen if your server's PHP version is too old for the plugin, or if server resources are insufficient.
    Solution: Check the plugin's requirements and ensure your server meets them (especially PHP version). Contact your hosting provider to upgrade PHP if necessary. If your site broke, you might need to access your site via FTP/File Manager to rename the plugin folder (wp-content/plugins/woo-razorpay) to deactivate it and regain access to your dashboard.

Pro Tip: Always check your WooCommerce System Status Report (WooCommerce > Status) for general issues and your server error logs for more detailed technical failures. Razorpay also provides transaction and webhook logs in its dashboard, which are invaluable for debugging.

Troubleshooting requires a methodical approach. By addressing these common issues, you can efficiently resolve most integration challenges when you integrate Razorpay with WooCommerce website, ensuring a smooth payment experience for your customers.

Need an Expert? Let WovLab Handle Your Payment Gateway Setup Flawlessly

While this guide provides a comprehensive, step-by-step roadmap to integrate Razorpay with your WooCommerce website, the reality of e-commerce operations often presents unique challenges. For many business owners, navigating the intricacies of payment gateway integration, ensuring compliance, optimizing conversion flows, and troubleshooting unforeseen issues can be a significant drain on time and resources – time better spent focusing on core business growth, marketing, and customer engagement.

This is precisely where WovLab steps in as your trusted digital agency partner. Based in India, WovLab (wovlab.com) specializes in providing end-to-end solutions for online businesses, ranging from cutting-edge AI Agent development and robust ERP systems to advanced SEO, digital marketing, and, critically, flawless payment gateway integrations. Our team of expert consultants possesses deep technical knowledge of both WooCommerce and Razorpay's ecosystem, ensuring your setup is not just functional, but optimized for performance, security, and scalability.

Why choose WovLab to manage your payment gateway integration?

• Seamless Integration: We handle the entire process, from setting up your Razorpay merchant account (including KYC assistance) to installing, configuring, and thoroughly testing the integration with your WooCommerce store. We ensure every detail, from API keys to webhook settings, is meticulously managed.
• Optimized for Conversions: Our expertise goes beyond mere technical setup. We implement best practices for checkout flow design, ensuring a smooth, intuitive, and high-converting payment experience for your customers, directly impacting your bottom line.
• Robust Security & Compliance: Payment security is non-negotiable. WovLab ensures your integration adheres to all PCI DSS standards and local regulatory requirements, safeguarding both your business and your customers' sensitive data. We also advise on SSL certificate best practices.
• Proactive Troubleshooting & Support: Should any issues arise – whether a payment failure, a webhook error, or a general system glitch – our team is equipped to diagnose and resolve problems swiftly, minimizing disruption to your sales. We offer ongoing support and maintenance packages tailored to your needs.
• Custom Solutions: Every business is unique. Whether you require custom payment logic, subscription billing integration, or specific reporting features, WovLab can develop bespoke solutions to extend Razorpay's functionality within your WooCommerce environment.
• Expert Guidance: Beyond the initial setup, we provide expert consultation on managing your payments, understanding analytics, and leveraging Razorpay's advanced features to their full potential.

Don't let technical hurdles stand between your business and seamless online transactions. Partner with WovLab to transform your payment processing into a competitive advantage. Focus on growing your business, and let us handle the complexities of ensuring your customers enjoy a secure, efficient, and effortless checkout experience. Visit wovlab.com today to learn more about how our payment gateway services can empower your WooCommerce store.