How to Accept UPI Payments on WordPress: QR Code vs Payment Gateway

how to accept UPI payments on WordPress

India’s digital commerce market moves fast. In January 2025, the country recorded more than 16.99 billion UPI transactions. Street vendors, freelancers, local shops, D2C brands, and premium stores all rely on this familiar mobile method.

If you run a WordPress site, supporting this option can make checkout feel easier for Indian shoppers. Customers can complete a transaction through a mobile app without a debit or credit card. That simple path may reduce hesitation and abandoned carts.

This guide compares two practical choices: displaying a QR code or using a payment gateway plugin. A QR code offers a quick manual route, while a gateway can send approved requests to your account and confirm each transaction. You will also see where a UPI payment gateway fits, plus key points for adding a trusted checkout option.

Key Takeaways

  • UPI suits Indian shoppers who use mobile apps every day.
  • A QR code provides a simple checkout path.
  • A gateway plugin can automate confirmation.
  • Card-free checkout may support more completed orders.
  • The right choice depends on your store’s needs.

What You Need to Accept UPI Payments on WordPress

Before adding this option, review your store tools, server setup, and merchant account. A smooth start helps each customer reach checkout with fewer delays.

How UPI Payments Work for Indian Customers

A shopper selects the UPI method, enters a VPA, or chooses an available flow. The customer then approves the request inside a UPI app. A gateway can report the result and link it with the order.

WooCommerce or a Custom Build?

WooCommerce offers the simplest route for most stores. Paytm supports cards, net banking, wallets, and this mobile payment method through compatible plugins.

Make sure your setup includes a supported version, PHP-cURL, WooCommerce, and a merchant account. A custom WordPress site can use a PHP SDK or REST API without WooCommerce. Developer work may take about four to eight hours.

  • WooCommerce store: use a maintained plugin.
  • Custom business site: use API development.
  • Small seller: compare QR and gateway needs.
Setup Best fit Main need
WooCommerce Online store Compatible plugin
Custom build Unique checkout SDK or REST API
QR route Manual orders VPA and verification

How to Accept UPI Payments on WordPress With a QR Code

A QR option gives Indian shoppers a familiar route at checkout. It works well for small stores, service providers, and manual orders. A simple plugin can place a upi code beside the order amount and clear instructions.

Adding a UPI QR Code to Your Checkout Page

Use a dynamic code when possible. It links each order with a unique amount, which limits confusion from reused images. PhonePe, Google Pay, and Paytm can support intent flows through a mobile upi app. A custom site may also create a QR or intent URL through a PHP SDK.

If you need a payment gateway, check whether its gateway plugin supports QR creation. You can also run a custom setup without WooCommerce. Make sure the amount, order number, and merchant name appear beside the upi code.

Verifying Payments and Updating Order Status Manually

After a customer pays, review the merchant dashboard. Match the amount, order ID, and UTR before fulfillment. Record each payment in your order log. Manual checks take longer than an automated upi payment gateway, but they help prevent false confirmations.

Option Best use Key check
Static QR Low-volume sales Match UTR and amount
Dynamic QR Unique orders Confirm order reference
Gateway plugin Growing stores Review webhook status

How to Add a UPI Payment Gateway Plugin to WooCommerce

A reliable gateway can connect your WooCommerce store with familiar Indian payment apps. Choose a maintained plugin with clear support, recent reviews, and matching WooCommerce requirements.

Choosing a Compatible and Maintained Plugin

Make sure the plugin supports your site version, PHP-cURL, and provider account. Paytm lists support for WordPress 3.9.2 or newer, WooCommerce 2.4 or newer, and PHP 5.6 or newer. Paytm also requires a registered business account.

Installing the Plugin and Entering API Keys

Open Plugins, add the chosen gateway plugin, and activate it. Next, visit WooCommerce settings and select the payment method. Enter the merchant ID, merchant key, and API keys from the provider dashboard.

Configuring Test Mode, Webhooks, and Checkout Settings

Paytm uses separate staging and live API keys. Its test mode does not deduct money from your merchant account. Add the generated webhook URL in the provider account, then review callbacks and order creation.

“Test mode protects your live account while you check the full checkout path.”

VyaparGateway sets a 15-minute intent expiry by default. Keep test mode active until the checkout page, webhook response, and payment details work correctly.

QR Code vs Payment Gateway for WordPress

Your store’s best checkout path depends on order volume, staff time, and shopper needs. A QR code offers a low-cost start for freelancers and small Indian merchants. It supports quick UPI payments, though you must match each payment with the order before fulfillment.

QR code and payment gateway comparison

A payment gateway suits a busy store. It can automate confirmation, order updates, refunds, and reports. A upi payment gateway also gives your customer a familiar payment method with low fees and quick settlement.

UPI avoids cards, OTP steps, and some card charges. Cards may settle later and need extra verification. Paytm supports debit cards, credit cards, net banking, UPI, and wallets. Wallet top-ups may still limit available funds.

  • Choose a QR code for simple, low-volume sales.
  • Choose a gateway plugin for growing WooCommerce checkout needs.
  • Review fees, dynamic QR support, reports, refunds, and setup effort.
Factor QR code Payment gateway
Best fit Freelancer or small merchant High-volume store
Confirmation Manual UTR check Automated status
Options UPI Cards, wallets, net banking, UPI
Growth Limited reporting Refunds and detailed reports

How to Test Your UPI Payment Setup Before Going Live

A careful trial gives you confidence before real customers reach checkout. Use a low-value order and keep your merchant account in test mode during the first review.

Completing a Test Order With Your UPI App

Select the UPI payment option, scan the rendered QR, and approve the request with your own UPI app. Check the amount, merchant name, and customer UPI flow from both desktop and mobile devices.

Checking Webhooks, UTRs, and WooCommerce Order Status

Open the payment gateway dashboard and confirm the transaction. Match the UTR with the order amount. A successful VyaparGateway test should move the order status to Processing within about 10 seconds. The UTR should also appear in the order notes.

Review the webhook URL, callback response, and API keys before leaving test mode. Paytm test mode does not deduct funds from your account. After launch, verify that funds reach your bank account.

  • Check the gateway result and UTR.
  • Confirm the plugin updates each order.
  • Repeat the test across devices.
Check Expected result Action
QR scan App opens correctly Approve the request
Callback Status updates quickly Review order notes
Settlement Funds reach your bank Match the amount

Security, Compliance, and Refunds for WordPress UPI Payments

Trust begins with a protected checkout. Use HTTPS across your site, keep software current, and limit access to merchant details. A dynamic QR code with an expiry time also reduces misuse from old or altered requests.

UPI payment gateway security

Protecting Checkout Data and Callback Traffic

Choose a payment gateway plugin that supports secure callback URLs. Review each webhook response, block unknown requests, and test status updates in a safe environment. Regular plugin updates close known security gaps. Keep your plugin wordpress setup free from abandoned extensions.

Knowing the Roles of Banks, TPAPs, and NPCI

TPAP means Third Party Application Provider. NPCI approves TPAPs, while banks and licensed payment aggregators manage processing and settlement. Only authorized providers can handle UPI payments. You do not need a TPAP license; your chosen gateway provider manages regulated connectivity.

For a failed or canceled order, an integrated gateway can return the amount to the customer’s original UPI source. Review refund status in your merchant account, then retain clear records for support and audits.

How to Fix Common UPI Plugin and Checkout Errors

A successful bank alert does not always update your store. Start with gateway settings, API keys, the webhook URL, and the provider dashboard. Check order notes and the customer UPI confirmation before changing the order status by hand.

Payment Completed but Order Status Is Still Pending

Review the payment gateway plugin logs first. Wordfence may block webhook POST requests as suspicious. Basic authentication can also stop a gateway from reaching a staging endpoint. Remove these barriers, then test another browser, device, or app such as PhonePe, Google Pay, or Paytm.

Webhook, Cache, and Plugin Compatibility Problems

Confirm the gateway plugin matches your current WordPress and WooCommerce version. Check the URL in settings and exclude the checkout page plus webhook endpoint from caching. Aggressive cache rules can show an old QR code or delay status updates. Keep INR selected, since this flow supports INR only.

  • Review logs, callbacks, and order notes.
  • Check plugin compatibility before API errors.
  • Use fresh QR data during each customer session.
Issue Likely cause Best action
Pending order Blocked webhook Review security logs
Old QR code Checkout cache Exclude dynamic pages
API error Version mismatch Update the plugin

Conclusion

Your checkout choice should match your volume, staff time, and growth plans. A QR route suits a small business that needs a low-cost way to accept UPI and can verify each order by hand. A maintained WooCommerce plugin fits a busy site that needs quick status updates, refunds, and webhook records.

India recorded 16.99 billion UPI transactions in January 2025. That reach makes familiar upi payments a smart customer service choice. Before launch, run a real test, match the UTR, check the order status, and confirm bank credit. Keep HTTPS active, use a fresh QR, guard webhook endpoints, and update each payment plugin.

As your business grows, your needs may expand beyond upi payment. Review cards, wallets, net banking, subscriptions, and wider payment gateways. The right gateway can help you accept payments with less manual work. Begin with adding upi if that matches your audience, then compare gateways as volume rises.

FAQ

What do you need for UPI payments in WordPress?

You need a merchant account, a WooCommerce store or custom site, HTTPS, and a suitable payment gateway plugin. Your provider may also request business details, API keys, and a verified bank account.

Can you add a QR code to the checkout page?

Yes. Add a static or dynamic QR code within the checkout page. A customer scans it with a UPI app, completes the payment, and shares the transaction reference when manual review is required.

Is a payment gateway better than a QR code?

A gateway gives you automated payment confirmation, order updates, refunds, and dashboard reports. A QR code costs less, but you may need to review each order manually.

Which plugin works best with WooCommerce?

Pick a maintained plugin that supports your WooCommerce version, gateway provider, currency, and checkout setup. Review support quality, update history, security practices, and refund features before installation.

Where do you enter API keys for a gateway plugin?

Open the plugin settings from your dashboard. Select the live or test account, enter the API keys, save the details, and confirm that the correct merchant account is linked.

What should you test before launch?

Turn on test mode, place a test order, scan the QR code with a supported app, and review the result in your gateway dashboard. Check the checkout page, receipt, customer email, and order status.

Why is an order still pending after a successful payment?

The webhook may be missing, blocked, or linked with the wrong URL. Check the webhook URL, API keys, gateway logs, cache settings, and server firewall. Then compare the UTR with the merchant account record.

Can customers use credit cards or net banking with this setup?

Many gateways support credit cards, debit cards, net banking, wallets, and UPI. Review the available payment methods in your provider account, since features vary by business type and region.

What security steps protect your checkout?

Use HTTPS, trusted plugins, strong dashboard access, and secure callback URLs. Keep the plugin and WordPress version current. Never publish API secrets in page content or customer messages.

Who handles compliance for this payment method?

Your gateway, bank, TPAP, RBI rules, and NPCI standards may each have a role. Check your provider’s merchant terms, refund rules, data policy, and settlement schedule before launch.

Can you use a QR code without WooCommerce?

Yes. A custom WordPress site can show a QR code, payment instructions, and a confirmation form. For automatic order tracking, connect a gateway with webhook support and a secure order database.