WordPress Payment Gateway Plugin
Accept UPI, cards, net banking, wallets and EMI on your WordPress site — installed from your dashboard in about 20 minutes, with no code. This is the complete India setup guide: the plugin, the credentials, the sandbox test, the errors everyone hits, and the checklist before you take a real customer's money.
Updated 20 August 2026 · Written for Indian businesses · Free plugin, no licence fee
Why this matters for a new store: the cap is ₹20 lakh of transaction value per month, against a standard rate of 1.95% — so a WordPress shop doing ₹3 lakh a month keeps roughly ₹5,850 every month that would otherwise go in fees, for as long as the offer runs. Two conditions are worth knowing before you count on it: volume above ₹20 lakh in a month is charged at the standard rate, and Cashfree requires UPI to stay at a minimum 40% of your monthly transaction value or the offer is withdrawn. It applies to merchants signing up on or after 21 July 2026 and runs until 31 March 2027.
How to add a payment gateway to WordPress — quick answer
Updated 20 August 2026To add a payment gateway to WordPress, open a merchant account with a payment provider, then install that provider's official plugin from Plugins → Add New in your WordPress dashboard. Activate it, go to WooCommerce → Settings → Payments, select the gateway, and paste the App ID and Secret Key from your provider dashboard. Leave sandbox mode on to place a test order, then switch it off, paste your production keys and whitelist your store domain to go live. The whole configuration takes 15–30 minutes and needs no code. If your site has no WooCommerce, a shortcode payment button or a payment link collects money without a cart.
- Setup time
- 15–30 min
- Coding needed
- None
- Plugin cost
- Free
- Needs WooCommerce
- Only for carts
Four ways to take payments on WordPress
Most guides assume you run WooCommerce. Plenty of WordPress sites do not — a consultant collecting a fee, a clinic taking a booking deposit, a school collecting term fees. Pick the row that describes your site, not the one with the most features.
| Method | Best for | WooCommerce? | Effort |
|---|---|---|---|
| WooCommerce plugin | A real online store with a cart, stock and order management | Yes | 15–30 minutes, no code |
| Payment button shortcode | A WordPress site with no cart — one product, a service fee, a booking deposit | No | 10 minutes, paste a shortcode |
| Payment links | Selling over WhatsApp, phone or email with no checkout at all | No | Under 5 minutes, nothing to install |
| Hosted payment page | Donations, fees and order forms where you would rather not host the form | No | Under 15 minutes, no website changes |
[CFPB], taking the title, description and orderAmount from custom fields on the page. No cart, no product catalogue.What your site needs first
Check these before you install anything. Six of the most common "the plugin doesn't work" complaints are actually one of these six rows.
| Requirement | Minimum | Why |
|---|---|---|
| WordPress | 4.4 or higher | The directory lists the plugin as tested up to WordPress 6.8.8. Anything newer usually works, but test on a staging copy first. |
| WooCommerce | 3.0 and above | WooCommerce must be installed and activated before the gateway appears in the Payments list. |
| PHP | 5.6 or higher | Most Indian shared hosts now run PHP 8.x. Check under Tools → Site Health → Info → Server. |
| SSL certificate | Required | Your site must load on https://. Free Let's Encrypt certificates are included by nearly every host, and no gateway will approve an http-only checkout. |
| Cashfree merchant account | KYC approved | You need an App ID and Secret Key, which only exist once the account is created. Production keys appear after KYC is approved; test keys work immediately. |
| Whitelisted domain | Required before live payments | Your store URL must be whitelisted in the Cashfree dashboard. Payments fail on a domain that was never registered. |
Active installs
8,000+
Directory rating
4 out of 5
Tested up to
WordPress 6.8.8
Figures as listed for Cashfree for WooCommerce in the WordPress.org plugin directory, read 20 August 2026. Install the plugin from inside your own dashboard — Plugins → Add New — rather than downloading it, so WordPress keeps it updated for you.
How to install and set up the plugin, step by step
Eight steps from nothing to a live checkout. Nothing here requires editing a theme file or touching code.
- 1
Create your Cashfree merchant account
Sign up, then complete KYC with your business PAN, bank proof, entity registration document and GSTIN where applicable. You can install and test the plugin in sandbox mode while KYC is still under review — only live payments wait for approval.
- 2
Install the plugin from your WordPress dashboard
In WordPress, go to Plugins → Add New, search for “Cashfree”, then click Install Now and Activate. To install manually instead, download the zip from the WordPress.org directory, go to Plugins → Add New → Upload Plugin, choose the file, click Install Now and then Activate.
- Automatic: Plugins → Add New → search “Cashfree” → Install Now → Activate
- Manual: Plugins → Add New → Upload Plugin → select the .zip → Install Now → Activate
- 3
Copy your App ID and Secret Key
Open the Cashfree merchant dashboard and generate your API credentials. Use the test credentials while you are still building, and the production pair once KYC is approved. Treat the Secret Key like a password — it is never shown to shoppers and should never be pasted into a support ticket or a public forum.
- 4
Enable Cashfree in WooCommerce
Go to WooCommerce → Settings → Payments (called Checkout on older versions) and select Cashfree in the Payment Gateways list. Tick the Enable/Disable box to turn the gateway on.
- 5
Fill in the gateway settings
Set Title to the name shoppers see at checkout — “Cashfree Payments” or simply “UPI, Cards & Net Banking” works well. Set Description to a short reassurance line. Paste your App Id and Secret Key. Leave Enable Cashfree sandbox ticked while testing, and untick it before going live. Enable In Context keeps the payment window on your own page instead of redirecting the shopper away.
- Title — what appears on the checkout page
- Description — the line under the title
- App Id — from the Cashfree dashboard
- Secret Key — from the Cashfree dashboard
- Enable Cashfree sandbox — ON for testing, OFF for live
- Enable In Context — popup checkout, no page redirect
- 6
Whitelist your store URL
In the Cashfree dashboard, register the exact domain your store runs on — including www or its absence, and https://. This is a regulatory requirement, not a formality: an unregistered domain is the single most common reason a first live payment fails.
- 7
Place a test order
With sandbox mode on, buy a low-value product from your own storefront using Cashfree's test credentials. Confirm three things: the payment window opens, the order status moves to Processing in WooCommerce, and the customer receives the order email.
- 8
Switch to production and test again with a real ₹1 order
Untick Enable Cashfree sandbox, replace the test App Id and Secret Key with your production pair, and save. Then buy a ₹1 item from your own store with a real UPI app and refund it from the WooCommerce order screen. That one test proves the whole loop — charge, order status, and refund — before a real customer ever sees it.
What your WordPress checkout can accept
One gateway account covers every method below — you do not install a separate plugin for UPI and another for cards.
UPI — every app
GPay, PhonePe, Paytm, BHIM, plus UPI intent on mobile and QR on desktop.
Cards
RuPay, Visa, Mastercard, Amex and Diners, including RuPay credit card on UPI.
Net banking
Major Indian banks, which still carry most large-ticket B2B payments.
Wallets & Pay Later
Wallet balances and buy-now-pay-later options at checkout.
EMI
Card, cardless and no-cost EMI for higher-value baskets.
Cash on delivery
Managed as a WooCommerce payment method, with refunds handled through the plugin.
Features worth turning on
- In-context popup checkout — the payment window opens over your own page instead of redirecting
- Instant refunds from the WooCommerce order screen, for online and COD orders
- Pre-authorisation on card payments, so you can hold an amount and capture later
- Instant settlements, when cash flow needs the money before the standard cycle
- High-Performance Order Storage compatibility for large WooCommerce catalogues
- Order ID prefix, so several stores can share one merchant account cleanly
Errors everyone hits, and how to fix them
Six problems account for most WordPress payment gateway support tickets. Each one has a specific cause and a specific fix.
“Authentication Failed” when a customer tries to pay
Cause: The App ID and Secret Key do not match the mode the plugin is running in — production keys with sandbox ticked, or test keys with sandbox unticked.
Fix: Open WooCommerce → Settings → Payments → Cashfree and make the Enable Cashfree sandbox checkbox match the key pair you pasted. Production keys need sandbox OFF.
Cashfree does not appear in the Payments list
Cause: WooCommerce is not active, or the plugin activated but WooCommerce loaded after it.
Fix: Confirm WooCommerce is active and at version 3.0 or above, then deactivate and reactivate the Cashfree plugin so it registers the gateway.
Payment succeeds but the WooCommerce order stays “Pending payment”
Cause: The shopper closed the browser before being returned to your site, so the confirmation never reached WordPress, or a caching or security plugin blocked the return request.
Fix: Exclude your checkout, cart and account pages from caching, and allow the Cashfree return URL through any firewall or bot-protection plugin. Cross-check the transaction in the Cashfree dashboard before treating an order as unpaid.
Live payments fail although test payments worked
Cause: The store domain was never whitelisted, or production keys were not swapped in.
Fix: Whitelist the exact live domain in the Cashfree dashboard and confirm the production App Id and Secret Key are saved with sandbox mode off.
The checkout redirects away and shoppers drop off
Cause: In-context checkout is turned off, so the payment page opens as a full redirect.
Fix: Tick Enable In Context so the payment window opens over your own checkout page. Fewer context switches means fewer abandoned carts on mobile.
Refund fails from the WooCommerce order screen
Cause: Refunds are issued through the API, so the saved credentials must be the same production pair that took the original payment, and the account must hold enough settled balance.
Fix: Check that the keys have not been rotated since the order, and confirm the refund in the Cashfree dashboard if WooCommerce reports an error.
Before you take a real payment — the checklist
Run through this once. It is faster than explaining a failed order to a customer, and most of it is also what a gateway checks during KYC review.
- Site loads on https:// with a valid SSL certificate
- Contact, Terms, Privacy, Refund and Shipping policy pages are published and linked in the footer
- Prices and delivery timelines are stated clearly on product pages
- Store domain is whitelisted in the Cashfree dashboard, exactly as it resolves
- Production App Id and Secret Key are saved, with sandbox mode switched off
- A real ₹1 order has been paid and refunded end to end
- Cart, checkout and account pages are excluded from caching
- Order confirmation emails reach the customer and the store inbox
- Bank account on the gateway matches the business PAN, so settlements are not held
WordPress payment gateway — frequently asked questions
What is a WordPress payment gateway plugin?
A WordPress payment gateway plugin connects your website to a payment service provider so customers can pay by UPI, card, net banking or wallet without leaving your site. It adds the payment option to your checkout, sends the order amount to the gateway, and updates the order once the money is confirmed. On a WooCommerce store the plugin appears under WooCommerce → Settings → Payments; on a site without WooCommerce a shortcode-based button does the same job for a single product or fee.
Which is the best payment gateway plugin for WordPress in India?
For an Indian WooCommerce store, the official plugin of whichever gateway you hold an account with is the right choice — an unofficial or third-party bridge plugin is the usual cause of failed orders. Cashfree for WooCommerce is a strong default because it is maintained by Cashfree, supports UPI, cards, net banking, wallets, EMI and cash on delivery in one gateway, and handles refunds and instant settlements from inside the WooCommerce order screen. Compare it against your own payment mix rather than a generic ranking.
How do I add a payment gateway to WordPress without WooCommerce?
Use a payment button plugin and place its shortcode on any page or post. Cashfree's Quick Button plugin, for example, renders a pay button from the shortcode [CFPB] with the product title, description and orderAmount supplied as custom fields — no cart, no product catalogue and no WooCommerce required. If you would rather install nothing at all, a payment link or a hosted payment page collects money with only a URL.
Is the Cashfree WooCommerce plugin free?
Yes. The plugin is published free in the WordPress.org plugin directory and there is no licence fee to install or use it. You pay the gateway's transaction charges on payments you actually collect, which are set by Cashfree and confirmed on your account — and new merchants signing up from 21 July 2026 pay 0% payment gateway fees on up to ₹20,00,000 of domestic transaction value per month until 31 March 2027, against a standard rate of 1.95%, subject to Cashfree's published conditions.
How long does it take to set up a payment gateway on WordPress?
Installing and configuring the plugin takes 15 to 30 minutes and needs no code. The longer part is merchant approval: KYC review depends on how complete your documents are and whether your site carries the required policy pages. You can install the plugin and run sandbox test payments while KYC is still in progress.
What documents do I need to open a payment gateway account in India?
You need your business PAN, bank account proof such as a cancelled cheque or statement, a registration document matching your entity type, your GSTIN if you are registered, and the signatory's Aadhaar-linked mobile for KYC. Your website is checked too — contact details, terms and conditions, privacy policy, refund and cancellation policy, shipping and delivery policy where you ship goods, and clear pricing. Missing policy pages are the most common reason an application is delayed.
Can I accept UPI payments on my WordPress site?
Yes. Once the gateway plugin is configured, UPI appears as a payment option at checkout, including UPI intent on mobile — which opens GPay, PhonePe or Paytm directly — and QR for desktop shoppers. UPI is now the majority of online collection for most Indian small businesses, so it is worth confirming it is enabled and tested before launch.
Do I need an SSL certificate for a WordPress payment gateway?
Yes, and it is not optional. Your store must load over https:// before a gateway will approve it, and browsers now warn shoppers away from any page that asks for payment details without it. Almost every host includes a free Let's Encrypt certificate; enabling it is usually a single toggle in your hosting panel.
Why does my WooCommerce order stay on “Pending payment” after a successful payment?
The payment confirmation did not reach WordPress — usually because the shopper closed the tab before being returned, or because a caching or firewall plugin blocked the return request. Exclude cart, checkout and account pages from caching, allow the gateway's return URL through your security plugin, and always check the gateway dashboard before treating an order as unpaid.
Can I issue refunds from inside WooCommerce?
Yes. The Cashfree plugin supports refunds initiated from the WooCommerce order screen, for online payments and for cash-on-delivery orders, so you do not have to switch to the gateway dashboard to return money. The saved API credentials must be the same production pair that took the original payment.
What is In-Context or popup checkout, and should I turn it on?
In-context checkout opens the payment window on top of your own checkout page instead of redirecting the shopper to another site. Turn it on. Every redirect is a moment where a shopper on a slow mobile connection can lose confidence or lose the page, and keeping the payment inside your own branding measurably reduces abandonment.
Does the plugin work with Elementor, Divi or a page builder?
Yes. The gateway attaches to WooCommerce itself, not to your theme or builder, so any Elementor, Divi, Astra or block-theme store that runs WooCommerce works the same way. If your site has no WooCommerce at all, use the shortcode payment button instead — page builders accept shortcodes in a text or shortcode widget.
Is the Cashfree 0% payment gateway fee offer real, and who qualifies?
Yes. Cashfree publishes 0% on domestic payment gateway transactions — UPI, cards, net banking and wallets — for merchants who sign up on or after 21 July 2026, on up to ₹20,00,000 of transaction value per month, running until 31 March 2027. The standard rate it replaces is 1.95%. Two conditions matter: volume above ₹20 lakh in a month is charged at the standard rate, and UPI must stay at a minimum 40% of your monthly transaction value or the offer is withdrawn. International cards, EMI and Pay Later are priced separately. Confirm the current terms on Cashfree's own charges page before signing up.
Can I use more than one payment gateway plugin at the same time?
Yes, WooCommerce lets you enable several gateways and shoppers pick one at checkout. In practice most stores are better served by one well-tested gateway plus cash on delivery: every extra option is another integration to monitor, another reconciliation to do at month end, and one more choice slowing the shopper down.
What happens to my WordPress store if a payment gateway account is suspended?
Checkout stops working, so keep a second collection route ready — payment links, a hosted page or cash on delivery will keep orders flowing while you resolve it. Suspensions usually follow a mismatch between what your site sells and what the account was approved for, or missing policy pages, so keeping those accurate is the cheapest insurance available.
Put a working checkout on your WordPress site this week
Create the account, finish KYC once, install the free plugin, and start collecting UPI and cards on your own domain. New merchants signing up now pay 0% payment gateway fees on up to ₹20 lakh a month of domestic sales, until 31 March 2027.
Sources & disclosure
- Cashfree for WooCommerce — WordPress.org plugin directoryhttps://wordpress.org/plugins/cashfree/
- Cashfree Payments — WordPress plugin documentationhttps://www.cashfree.com/docs/payments/plugins/wordpress
- Cashfree Payments — WooCommerce plugin documentationhttps://www.cashfree.com/docs/payments/plugins/woocommerce
- Cashfree Payments — payment gateway chargeshttps://www.cashfree.com/payment-gateway-charges/
Signing up? Use the link below so the 0% offer and your account are tracked against this guide.
Open your accountRead 20 August 2026. Plugin version numbers, install counts and promotional terms change — confirm the current details on the provider's own pages before you sign up. Bill Bazaar is an independent referral partner for Cashfree Payments and may earn a commission if you open an account through a link on this page, at no extra cost to you. We are not Cashfree: pricing, approval, KYC and support are handled by them directly. WordPress and WooCommerce are trademarks of their respective owners; this page is not affiliated with or endorsed by them.


