1pospay logo

Payments · Setup guide

Set Up Razorpay on WooCommerce in Singapore

How to add Razorpay to WooCommerce in Singapore: plugin install, API keys, payment action, automatic webhooks, test cards, going live and fixes for common errors.

By 1 POS Pay ·

General information for Singapore businesses, not financial or legal advice. Fees and terms are set by each payment provider and can change. Check the provider's current terms and its licence status on the MAS Financial Institutions Directory.

Razorpay on WooCommerce: the short answer

You add Razorpay to WooCommerce with the official Razorpay for WooCommerce plugin. Install and activate the plugin, open WooCommerce, Settings, Payments, click Razorpay, paste your Key ID and Key Secret, set Payment Action to Authorize and Capture and save. The plugin sets up its webhooks automatically. In Singapore the checkout then accepts cards and PayNow.

Sign up through the 1 POS Pay Razorpay page first if you do not have an account yet: the partner link gives you 2.50% + S$0.15 on domestic cards and PayNow capped at S$4, and the same account works with this integration.

What you need before you start

Razorpay's documentation lists WordPress 3.9.2 or higher, WooCommerce 4.0 or higher, PHP 7.0 or higher and the php-cURL extension. You also need a Razorpay account and API keys.

In the Razorpay Dashboard, choose Test or Live mode, then go to Account & Settings, API Keys and click Generate Key. Only users with the Owner or Admin role can do this. The Key Secret is shown once, so download and store it safely. Test keys work straight away; Razorpay asks for your website details before it issues Live keys and says it verifies them within 3 working days.

Install and configure the plugin step by step

These steps follow Razorpay's WooCommerce documentation for Singapore.

Adding Razorpay to WooCommerce, from Razorpay's Singapore documentation, November 2026.
StepWhat to do
1In WordPress, add the plugin from the Plugin Directory (wordpress.org/plugins/woo-razorpay), or download the latest zip from Razorpay's GitHub releases and upload it to /wp-content/plugins/.
2Activate the Razorpay plugin in the WordPress plugin manager.
3Go to WooCommerce, Settings, then the Payments tab, and click Razorpay.
4Enable the payment method and give it the title customers will see, for example Credit Card / Debit Card / PayNow.
5Enter your Key ID and Key Secret from the Razorpay Dashboard.
6Set Payment Action to Authorize and Capture, so payments are captured automatically.
7Click Save Changes. From plugin version 3.5.0 this also creates the webhooks.

Why Authorize and Capture matters

If you set Payment Action to Authorize only, each payment waits for you to capture it by hand. Razorpay's documentation warns that payments left uncaptured are refunded automatically after 5 days. Most shops should use Authorize and Capture.

Check the webhooks

Webhooks tell WooCommerce that a payment succeeded even if the customer closes the browser early. The plugin creates them when you save your keys. To check, open the Razorpay Dashboard, go to Account & Settings, then Webhooks, and confirm an active webhook for your shop. If you regenerate your API keys, save the plugin settings again. If a payment shows as captured in Razorpay but the WooCommerce order is not updated, check the webhook and make sure your firewall allows Razorpay's webhook requests.

Test a payment, then go live

Enter your Test mode keys in the plugin and place an order. Razorpay's documentation gives two test cards: Mastercard 5272 0088 0623 5705 and Visa 4111 1111 1111 1112, with any CVV and any future expiry date. In test mode a mock page lets you choose Success or Failure, and PayNow shows the same kind of mock page. After a test payment, open the Razorpay Dashboard, go to Transactions, then Payments, and check that the status is captured.

To go live, switch the Razorpay Dashboard to Live mode, generate Live keys, and replace the test keys in WooCommerce, Settings, Payments, Razorpay. Place one small real order and refund it.

Limits and troubleshooting

The plugin supports WooCommerce Checkout Blocks and High-Performance Order Storage (HPOS). Partial payments are not supported, and only currencies with two decimal places work. Subscriptions need the paid WooCommerce Subscriptions extension and must have an end date.

The API key provided is invalid or Authentication failed means the keys in WordPress do not match the Dashboard, or you mixed test and live keys. A 404 on the payment page is fixed in WooCommerce, Settings, Advanced: set the pay endpoint to order-pay and the order received endpoint to order-received. Plugin logs are in WooCommerce, Status, Logs, under razorpay-logs. For most other errors Razorpay's advice is to delete the plugin and its webhook, then install the latest version.

Other platforms: Shopify, WooCommerce, Magento, and WordPress, PrestaShop and WHMCS.

Common questions

Does Razorpay work with WooCommerce in Singapore?

Yes. Razorpay's Singapore documentation covers the official Razorpay for WooCommerce plugin, which adds cards and PayNow to your checkout. It needs WordPress 3.9.2 or higher, WooCommerce 4.0 or higher and PHP 7.0 or higher.

Where do I enter Razorpay API keys in WooCommerce?

Go to WooCommerce, Settings, Payments and click Razorpay. Enter the Key ID and Key Secret generated in the Razorpay Dashboard under Account & Settings, API Keys, then click Save Changes.

Do I need to set up webhooks for Razorpay on WooCommerce?

Not by hand on plugin version 3.5.0 or later. The plugin creates the webhooks when you save your Key ID and Key Secret. You can confirm them in the Razorpay Dashboard under Account & Settings, Webhooks.

Why were my Razorpay payments refunded automatically?

The plugin was probably set to Authorize instead of Authorize and Capture. Razorpay refunds payments that are authorised but not captured within 5 days. Change Payment Action to Authorize and Capture.

Does the Razorpay WooCommerce plugin support subscriptions?

Yes, with conditions. You need the paid WooCommerce Subscriptions extension, and each subscription must have an end date. Partial payments are not supported.

Sources

Find the right payment provider

1 POS Pay matches Singapore businesses with MAS-licensed payment providers for card terminals, online payment gateways and payment links.

Talk to 1 POS Pay →