Troubleshooting & FAQs

The benefits of Magic Checkout are:

• Seamless prepaid and COD options
• Faster checkout experience
• Higher conversions
• Saved customer details
• Reduced RTOs (Return To Origin)
• Efficient promotions

Magic Checkout boosts conversions with a streamlined UI, auto-prefilled addresses and saved payments, visible coupons, personalised payment options, trust badges and COD Intelligence to block risky orders; delivering a faster, more seamless checkout experience.

Add items to your cart and click the Checkout button. If Magic Checkout is enabled, the Magic Checkout pop-up will appear instead of your regular checkout page. If this flow does not appear, raise a ticket with our

First, check if your website's theme was recently changed. If the theme is unchanged, raise a ticket with our

Raise a request with our

Magic Checkout's COD Intelligence uses risk analysis to block high-risk COD orders, helping reduce fake orders and RTOs.

To enable COD Intelligence on your

Yes, international payments is supported on Magic Checkout.

On the

At present, Magic Checkout is available only on

If Magic Checkout is causing conflicts with other plugins, disable any plugins that are not required. If the integration issue persists, contact our

No, we currently do not support restricting a coupon discount to first-time users.

Yes.

You can customise the look and feel of your checkout and rearrange payment methods or instruments to suit your requirements. Refer to the

No, we do not support using live and test keys simultaneously in a staging environment. The URL configured in live mode is used for testing. If you need a specific merchant ID (MID) hardcoded for testing, please reach out to your Razorpay SPOC for assistance.

Follow these

No, SSO is not supported. You will need to log in explicitly on the Razorpay Dashboard using your credentials.

The calls are failing due to timeouts. If the response time exceeds 10 seconds, the request is terminated, resulting in errors.

Yes, you can provide different types of payment offers to customers on checkout. Know more about how to

You can retrieve the GSTIN and order notes provided by a customer by querying the corresponding Razorpay order_id. These details are available in the order notes under the keys gstin and order_instruction respectively.

You can retrieve customer details by querying the Razorpay order associated with the customer.

Yes, you can customise Razorpay Checkout to reflect your brand colors and logos. Know more about how to

This is an on-demand feature. Please raise a request with our

If your domain’s firewall or cloud configuration is blocking requests to api.razorpay.com, you need to whitelist our public IPs. Know more about how to

Follow the steps given below if you are integrating with our plugin for the first time:

1. Create a Razorpay account

   .

2. Generate the API Keys

   from the Dashboard. Navigate to Account & Settings → API Keys (under Website and app settings).

3. Enable features on Razorpay Dashboard

   .

4. Install Razorpay Plugin: With the release of version 4.1.0, you can install the plugin directly from the

   WordPress Plugin Directory

   .
   Handy Tips

   Ensure you have the PHP-curl extension installed to make network requests.

5. Enable features on WordPress Dashboard

   . In addition to the other steps, scroll down to Razorpay under the Payments tab and click Manage to edit the settings.
   • Enable the Payment Method, name it Credit Card/Debit Card/Internet Banking (Displayed to your customer on the payment page).
   • Add in your [KEY_ID] and [KEY_SECRET] generated from the

     Razorpay Dashboard

     .
   • Set Payment Action to Authorize and Capture to auto-capture payments. If you want to capture payments manually from the Dashboard after manual verification then set the Payment Action to Authorize.
     

6. Accept Live Payments.

   • Generate the [KEY_ID] and [KEY_SECRET] in the Live mode on your Razorpay Dashboard.
   • Enter the Live mode [KEY_ID] and [KEY_SECRET] in your WooCommerce store.
   Handy Tips

   Disable the Test mode

   to accept live payments.

Follow these

To exclude draft orders: a. Click Analytics settings in the WooCommerce Dashboard. b. Navigate to the Excluded statuses section and select the check box for draft orders under the Unregistered statuses section.

• Auto-webhook support is available from Razorpay Woocommerce Plugin v2.7.2 onwards.

• You can configure only these events: payment.authorized, refund.created and virtual_account.credited.

  Handy Tips

  If you have enabled the COD option for your customers, you should manually subscribe to the payment.pending event.

• Once you configure auto-webhook on WooCommerce, you do not have to configure it on the Razorpay Dashboard.

To set up auto-webhooks:

1. In the WordPress Dashboard, click WooCommerce and go to Settings.
2. In the Payments tab, complete the following steps:
   • Select Enable Razorpay Webhook.
   • Webhook Events: From the list, select the events for which you want to receive notifications.
   • Webhook Secret: Enter the secret. This is a mandatory field as the secret is required for webhook signature verification.
3. Click Save Changes.
   

To verify if webhooks are enabled:

1. Log in to the Razorpay Dashboard and navigate to Account & Settings → Webhooks (under Website and app settings).

2. Select the relevant webhook URL.

3. On the right panel, check if the status for payment.authorized, refund.created and virtual_account.credited is enabled.

   Handy Tips

   If you have enabled the COD option for your customers, you should

   manually subscribe

   to the payment.pending event.

   

To enable Magic Checkout on your Shopify store, fill in the

Reach out to our support team at

Coupons is an on-demand feature. Fill in the

No, currently, we support coupons created in INR only.

Follow these

Coupons created on Shopify will not apply unless they are synced. To sync all coupons across different categories on Shopify:

1. On the

   Razorpay Dashboard

   , navigate to Coupons → Setup section.
2. Click Sync now next to the Coupons from Shopify section.
3. Enter the Start date and End date to set the sync duration for the coupon.
4. Click Start Sync.

No, coupons created on the Razorpay Dashboard cannot be synced back to Shopify. They only work within the Magic Checkout system.

By default, all the coupons synced from Shopify are in the created state. You must manually configure and publish the coupons. To publish a coupon, identify the coupon created on Shopify, click the options icon and click View and Edit (if required) or click Publish.

Yes, you can enable the Enable this coupon code only for Prepaid Payment methods option on the dashboard to disable COD payment for specific coupons, encouraging customers to use prepaid payment methods instead.

In the Buy X Get Y scenario, you must convey to your customers that to use this coupon, both the X and Y products should be present in their cart. For example, if the coupon offers a discount on a cap or provides it for free only when you buy a t-shirt, both items must be in your cart for the discount to apply.

After you publish a coupon, navigate to Coupons → Setup on the

Yes, you can edit the coupon. Navigate to Coupons → All Coupons, identify the coupon you want to edit, navigate to the options icon and click View and Edit.

The coupon will appear in a disabled state when users do not meet the cart or eligibility conditions When you enable Display this coupon at checkout option and then select Enable coupon as an unavailable coupon. Once conditions are met, the coupon automatically becomes available for use.

You can only deactivate a coupon and not delete it. Identify the coupon you want to deactivate, navigate to the options icon and click Deactivate.

Format:

• Mobile number: +919000090000
• Email id:

  gauravkumar@example.com

The refund process depends on the your refund policy. If approved, the refund will be processed as a standard refund, similar to the existing refund options that Razorpay offers. Know more about

You can configure shipping rates at product, zone and method levels for your customers. Follow these

When you configure shipping settings on the Razorpay Dashboard, these settings override any shipping configurations set up on your plugins or ecommerce platform. The dashboard settings take precedence over all other configurations.

No, each product can only belong to one shipping category. Once you add a product to a category, you cannot add it to another category within your shipping profiles.

Login with Razorpay, powered by Magic SSO, is a single sign-on system that allows customers to log in seamlessly across the Razorpay network using OTP-based authentication. It helps merchants collect valuable user data, personalise the shopping experience and improve conversions.

No, currently this feature is only available for Shopify users.

Yes, you can configure the login prompt to appear:

• On the first page a customer visits.
• After a customer adds their first item to the cart.
• During checkout (with the option to make login mandatory).

Know more about

Yes, you can customise how consent is collected from users. Know more about various options

Yes, you can customise the heading, emojis, background and button colours and fonts to match your brand. Know more about

Login rewards are incentives such as coupons offered to users who log in via the widget. You must create the coupon using

Automatic customer tagging refers to the process where Login with Razorpay (SSO) feature assigns specific tags to customer profiles in your Shopify store when they log in. These tags help identify returning users, track login methods and automate retargeting campaigns.

Tags are applied in real-time as soon as the customer logs in through Magic SSO.

Yes, when existing customers log in through Razorpay SSO, the system automatically applies the relevant tags.

Yes, you can edit or remove these tags like any other customer tag in Shopify. However, we recommend retaining them to ensure accurate automation and segmentation.

No, customer tags do not count towards any Shopify plan limits.