Add UPI to WooCommerce

Add UPI to WooCommerce in one of two ways. A direct QR plugin shows your UPI ID at checkout and keeps the order on hold until you match the reference. A gateway plugin opens UPI and sets the order to Processing when its webhook reports the payment as captured.

Which UPI path fits this WooCommerce store?

Most buyers on an Indian WooCommerce store already pay from PhonePe, Google Pay, Paytm, BHIM, or their bank app. WooCommerce does not ship that button. You add a plugin, and that plugin is either a direct pay-to-your-UPI-ID tool or a registered payment gateway.

Use the direct path when you can check every payment before you pack the order. Use a gateway when you also need cards, when more than one person packs orders, or when you cannot match references through the day.

Some plugins are UPI-only gateways with their own account and keys. The fee is on that account. WebJi® hosts the store. We are not that payment company, and we do not set their rate.

How do you show a UPI QR at checkout?

This path sends the money to a UPI ID you already have. There is no gateway KYC, and no gateway percentage comes off the payment. The order is not paid until you confirm the credit yourself.

1. In WordPress open Plugins, then Add New. Search for a WooCommerce UPI QR plugin. Install and activate one that adds a payment method at checkout. Skip a plugin that only prints a donation shortcode.
2. Open WooCommerce, then Settings, then Payments. Enable the UPI method. If it is not in the list, the plugin is not active.
3. Enter the store name buyers should see and the UPI ID from your own bank or UPI app. Save.
4. Open checkout on a computer. A QR for this order amount should appear. Open the same checkout on a phone. A pay button or a link should open a UPI app.
5. If the phone shows only a QR the buyer cannot scan, try another plugin before you go live. Some direct plugins hide UPI on an iPhone. Check an iPhone if your buyers use one.
6. Place one order for a product you control and pay it from your own UPI app. Copy the reference the app shows. WooCommerce should leave the order On hold.
7. In your UPI or bank app, find the same amount and the same reference. Only then set the order to Processing. If the reference is missing, leave it on hold and do not ship.

How do you add UPI through a gateway plugin?

Use this path when the payment should confirm itself. Razorpay, Cashfree, PayU, and PhonePe each ship a WooCommerce plugin. Pick the account you can finish. The Razorpay setup guide is the worked example for one of them. The button names differ. The checks do not.

1. Create the gateway account and finish the KYC it asks for. Live keys stay locked until that review is done. Use test keys while you learn the screen.
2. Install that gateway's official WooCommerce plugin from Plugins, then Add New. A payment-link plugin with a similar name is a different product. Activate the official one.
3. Open WooCommerce, then Settings, then Payments. Enable the gateway and paste the test key and secret. Save.
4. In the gateway dashboard, keep UPI switched on. Cards and netbanking can stay beside it. For buyers in India, UPI should be easy to see on the pay screen.
5. Copy the webhook address the plugin shows and add it in the gateway dashboard. Include the event for a captured payment.
6. Place one test order. It worked when WooCommerce says Processing and the test dashboard shows that same payment as captured. Then replace the test keys with live keys and pay one order you can refund the same day.

How do you know the UPI payment worked?

On the direct path, all four of these have to be true before you ship:

• Your UPI app shows the credit.
• The amount matches the order, and the reference matches what the buyer entered.
• You set the order to Processing yourself. The plugin did not.
• Stock falls once, and a refresh does not create a second order.

On the gateway path, the bar is the same idea with different proof:

• The WooCommerce order is Processing.
• The payment id on the order is captured in the gateway dashboard.
• Stock moved once.

A screenshot from the buyer is not one of these checks. Match the UPI reference, or the gateway payment id, before you pack the parcel.

What should you do with a failed or pending UPI payment?

A failed UPI attempt usually shows in the app at once. The buyer cancelled, the app timed out, or the bank declined it. The order stays unpaid. Let them try checkout again. Do not raise a second manual order until you know the first attempt was not captured.

A pending UPI payment is different. The bank may debit the buyer before the store hears about it. On a gateway, wait for the webhook, or look the payment up in that dashboard. Resend the captured-payment event if the money is captured and WooCommerce is still pending.

A direct QR plugin has no webhook. The order stays On hold until that reference shows in your UPI app. If checkout never reaches the pay button, the payment plugin is not the only cause. The WooCommerce checkout fixes cover a cart that stops before payment.

Where should this WooCommerce store be hosted?

The plugin does not host the shop. Checkout needs HTTPS, and a gateway plugin has to reach that gateway from the server. E-commerce hosting at WebJi® is the account for a WooCommerce store that takes UPI.

This page has no hosting price. Email support@webji.services and get a quote before you pay. The quote is in INR, before 18% GST.

Email that same address if the plugin will not activate, or if checkout cannot reach the gateway. Support replies in Hindi or English, and the average first reply is under 60 minutes. The office phone is not a support line. Do not call it for this.

Moving a store that already sells is not instant. Free migration is subject to terms and approval. WebJi® does not hold your UPI settlements, and we do not log in to your gateway dashboard for you.