Payments · Setup guide
Razorpay for WordPress, PrestaShop and WHMCS
How to set up Razorpay on a WordPress site without WooCommerce, on PrestaShop and on WHMCS in Singapore, plus what to do if your platform has no plugin.
By 1 POS Pay ·
Razorpay on other platforms: the short answer
Razorpay's Singapore documentation covers six platforms: Shopify, WooCommerce, Magento, WordPress, PrestaShop and WHMCS. This guide covers the last three. On each you install Razorpay's plugin or module, paste your Key ID and Key Secret, test with Razorpay's test cards and then switch to Live keys. All three accept cards and PayNow in Singapore. If your platform is not on the list, you can still take payment with a Razorpay payment link or payment page.
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.
Get your API keys first
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.
WordPress without WooCommerce: a Pay button on any page
The Razorpay Quick Payments plugin adds a Pay with Razorpay button to a WordPress page or post for a fixed amount. It suits a single service, a course fee or a deposit. If you run WooCommerce, use the WooCommerce plugin instead. The plugin needs WordPress 3.0.1 or higher and does not support subscriptions. Steps follow Razorpay's WordPress documentation.
| Step | What to do |
|---|---|
| 1 | In WordPress go to Plugins, Add New, install Razorpay Quick Payments (wordpress.org/plugins/razorpay-quick-payments) and click Activate Plugin. |
| 2 | Open the plugin's Settings. Tick Enable Razorpay Payment Module and set the Title and Description. |
| 3 | Enter your Key ID and Key Secret, set Payment Action to Authorize and Capture and click Save Changes. |
| 4 | On the page or post, turn on Custom Fields in the editor's Preferences, under Panels. |
| 5 | Add three custom fields: amount (in SGD), name and description. |
| 6 | Add the shortcode [RZP] where the Pay with Razorpay button should appear. |
PrestaShop
Razorpay's module supports PrestaShop 1.6, 1.7, 8.0 and 8.1. Download the release that matches your version from Razorpay's GitHub releases: the 1.x releases for PrestaShop 1.6 and the 2.x releases for 1.7 and 8. Steps follow Razorpay's PrestaShop documentation. From module version 2.5.0 the webhooks are created automatically when you save your keys.
| Step | What to do |
|---|---|
| 1 | Log in to the PrestaShop admin and open the Modules tab. |
| 2 | Click Add a New Module, click Browse, select the Razorpay ZIP file and click Upload this Module. |
| 3 | Click Install, then Configure. |
| 4 | Enter your Key ID and Key Secret and save. |
WHMCS
WHMCS is billing software for hosting companies and agencies. Razorpay's module supports WHMCS 6, 7 and 8. Steps follow Razorpay's WHMCS documentation. If your default currency is not Singapore dollars, set Convert for Processing to SGD and keep the exchange rate current.
| Step | What to do |
|---|---|
| 1 | Download the module from Razorpay's GitHub releases, unzip it and upload the contents to your WHMCS installation folder. |
| 2 | Log in to the WHMCS admin and go to Setup, Payments, Payment Gateways. |
| 3 | Choose Razorpay from the list and click Activate. |
| 4 | Enter your Key ID and Key Secret and click Save Changes. |
| 5 | Under Manage Existing Gateways, tick Enable Webhook, copy the webhook address shown and set a secret. |
| 6 | In the Razorpay Dashboard go to Account & Settings, Webhooks, Add New Webhook. Paste the address and secret, add an alert email, select the order.paid event and click Create Webhook. |
Test, then go live
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 on any of the three, switch the Razorpay Dashboard to Live mode, generate Live keys and replace the test keys in the plugin or module settings. Use automatic capture, because Razorpay refunds payments that are authorised but never captured.
If your platform has no Razorpay plugin
Razorpay's wider integrations list also names Wix, BigCommerce and OpenCart, but its Singapore documentation has no setup pages for them, so confirm with Razorpay before you rely on one. Two options work with any platform. A Razorpay payment link can be sent by WhatsApp, SMS or email, and a hosted payment page can be linked from any button on your site; Razorpay lists no additional charge for either. A developer can also integrate the API directly. See payment link vs payment gateway.
Other platforms: Shopify, WooCommerce, Magento, and WordPress, PrestaShop and WHMCS.
Common questions
Which platforms does Razorpay support in Singapore?
Razorpay's Singapore documentation has setup pages for Shopify, WooCommerce, Magento, WordPress, PrestaShop and WHMCS. For other platforms you can use Razorpay payment links, a hosted payment page or a direct API integration.
Can I use Razorpay on WordPress without WooCommerce?
Yes. The Razorpay Quick Payments plugin adds a Pay with Razorpay button to a page or post using the [RZP] shortcode and three custom fields: amount, name and description. It handles fixed amounts only and does not support subscriptions.
Which PrestaShop versions does Razorpay support?
PrestaShop 1.6, 1.7, 8.0 and 8.1. Use the 1.x module releases for PrestaShop 1.6 and the 2.x releases for 1.7 and 8. Webhooks are created automatically from module version 2.5.0.
How do I connect Razorpay to WHMCS?
Upload the Razorpay module to your WHMCS folder, go to Setup, Payments, Payment Gateways, activate Razorpay and enter your Key ID and Key Secret. Then enable the webhook in WHMCS and add it in the Razorpay Dashboard with the order.paid event.
Does Razorpay work with Wix in Singapore?
Razorpay's group integrations list names Wix, but its Singapore documentation has no Wix setup page. Confirm with Razorpay first. A Razorpay payment link or hosted payment page works with any website builder in the meantime.
