Troubleshooting & FAQs

• Auto-webhook support is available for Razorpay Woocommerce Plugin from v3.5.0 onwards.
• Once you save the changes on the WooCommerce dashboard, webhooks are auto configured for events: payment.authorized and refund.created. You do not have to configure it on the Razorpay Dashboard.

To set up webhooks:

1. In the WordPress Dashboard, click WooCommerce and navigate to Settings.
2. In the Payments tab, enter the Key ID and Key Secret.
   
3. Click Save Changes.
   

If you are not using the upgraded version of Razorpay WooCommerce plugin, you can manually configure the following events:

• payment.authorized
• payment.pending
• refund.created
• virtual_account.credited
• subscription.cancelled
• subscription.paused
• subscription.resumed

To set up webhooks manually:

1. Log in to the

   Razorpay Dashboard

   and navigate to Account & Settings.
2. In the Website and app settings section, click Webhooks.
   
3. Click + Add New Webhook.
   
4. In the Webhook Setup pop-up page:

   1. Enter the URL where you want to receive the webhook payload when an event is triggered. We recommend using an HTTPS URL.

      Handy Tips

      You can set up to 30 URLs to receive Webhook notifications. Webhooks can only be delivered to public URLs. If you attempt to save a localhost endpoint as part of a webhook setup, you will notice an error. Know more about

      testing Webhooks on an application running on localhost

      .

   2. Enter a Secret for the webhook endpoint. The secret is used to validate that the webhook is from Razorpay. Do not expose the secret publicly. Know more about

      how to validate webhooks

      .
      Handy Tips

      • When setting up the webhook, you will be asked to specify a secret. Using this secret, you can validate that the webhook is from Razorpay. Entering the secret is optional but recommended. The secret should never be exposed publicly.
      • The webhook secret does not need to be the merchant secret key provided by Razorpay.

   3. In the Alert Email field, enter the email address to which the notifications should be sent in case of webhook failure. You will receive webhook deactivation notifications to this email address.

   4. Select the required events from the list of Active Events.

      
      
      
5. Click Create Webhook. After you set a webhook, it appears on the list of webhooks.
   
6. You can select the webhook and click Edit to make more changes.

To verify if webhooks are enabled:

1. Log in to the

   Razorpay Dashboard

   and navigate to Account & Settings.
2. In the Website and app settings section, click Webhooks.
   
3. Select the relevant webhook URL.
4. On the right panel, check if the status for payment.authorized and refund.created is enabled.
   

No, partial payments are not supported on WooCommerce. You can either choose to deduct the full amount or make two separate orders and the customer will have to pay twice for it.

Verify and confirm that the API keys you have provided within WordPress are accurate. If the issue persists, contact our

The message in the logs is not an error, it is a logged message. This message appears only when a webhook callback takes longer than 5 minutes to process. Our webhook mechanism includes a 5-minute waiting period to prevent the occurrence of duplicate orders.

“Authentication failed” error occurs when there is a discrepancy between the API keys. Verify the API key provided for your website and ensure that it matches with the key generated via

Follow the steps given below to resolve the issue:

1. Deactivate and delete the Razorpay WooCommerce plugin from your

   WordPress Dashboard

   .
2. Reinstall the

   Razorpay WooCommerce plugin

   .
3. For easy integration journey, watch the

   Razorpay WooCommerce Integration tutorial

   .

If you encounter this error message while trying to activate the Razorpay for WooCommerce plugin, follow the steps given below to resolve the issue:

1. Uninstall the Razorpay for WooCommerce plugin from your WordPress Dashboard. Ensure you delete the plugin entirely, not just deactivate it.
2. Remove the WooCommerce webhook associated with Razorpay from your Razorpay Dashboard. Know how to

   delete a webhook

   .
3. After removing both the plugin and the webhook, install the latest version of the

   Razorpay for WooCommerce plugin

   .

If the issue persists even after following these steps, contact our

• WooCommerce version
• WordPress version
• Razorpay for WooCommerce plugin version
• A screen recording of the checkout flow (if possible)
• Staging site credentials (if applicable)
• Test Key and Secret from your Razorpay account

If you encounter this error, follow the steps given below to resolve the issue:

1. Log in to WordPress Dashboard, click WooCommerce and navigate to Settings.
2. In the Advanced tab, look for the Page Setup section. Ensure that you have correctly linked the Cart page and Checkout page.
   
3. Validate the Checkout Endpoints settings:

• For the Pay endpoint, set it to order-pay.
• For the Order Received endpoint, set it to order-received.
  

If the issue persists even after following these steps, contact our

Follow the troubleshooting steps given below:

1. Ensure that your system meets all the requirements mentioned

   here

   .
2. We recommend you to keep your WordPress, WooCommerce, and Razorpay for WooCommerce plugins up to date. You can find the latest versions

   here

   .
3. You can perform initial debugging. Follow the steps given below to debug:
   1. Deactivate all plugins except for Razorpay and WooCommerce.
   2. If you are using a paid theme, switch to a default WordPress theme and check if the issue persists.
   3. Verify if the Razorpay checkout is rendering correctly. If not, try reinstalling the Razorpay for WooCommerce plugin.
4. If the issue persists after following these steps, contact our

   Support team

   . Provide the following information while creating a ticket:
   • WordPress version
   • WooCommerce version
   • Razorpay for WooCommerce plugin version
   • PHP version
   • WordPress theme
   • Steps to reproduce the issue (Screen recording/Screenshots)
   • Error logs, if any
   • Staging website credentials (login URL, login id, and password)

To reconfigure webhooks for Razorpay in WooCommerce, follow the steps given below:

1. Deactivate and delete the Razorpay WooCommerce plugin from your

   WordPress Dashboard

   .
2. Remove the WooCommerce webhook associated with Razorpay from your Razorpay Dashboard. Know how to

   delete a webhook

   .
3. After removing both the plugin and the webhook, install the latest version of the

   Razorpay for WooCommerce plugin

   .

Follow the steps given below to revert to the legacy order confirmation page:

1. Open the Order Confirmation template in the Site Editor by navigating to Appearance → Editor → Templates → Order Confirmation.

2. Open the List View and delete all the special Order Confirmation blocks.

   Handy Tips

   Hold shift to select multiple blocks between the current selection and the block you click.

3. Open the Block Inserter, search for Order Confirmation Block and add it.

   

4. Click Save.

Yes, Razorpay WooCommerce supports High-Performance Order Storage(HPOS). It is recommended to enable this feature when there is minimal traffic in the store.

If you encounter this error message, follow the below steps to troubleshoot this issue:

1. Uninstall the Razorpay for WooCommerce plugin from your WordPress Dashboard. Ensure you delete the plugin entirely, not just deactivate it.
2. Remove the WooCommerce webhook associated with Razorpay from your Razorpay Dashboard. Know how to

   delete a webhook

   .
3. After removing both the plugin and the webhook, install the latest version of the

   Razorpay for WooCommerce plugin

   .

If the issue persists even after following these steps, contact our

Yes, Razorpay WooCommerce supports Checkout Blocks.

No, the WooCommerce subscription plugin is only available in the paid version of WooCommerce.

Yes, it is mandatory. We do not support subscriptions with no expiry date on the WooCommerce plugin.