Enabling Razorpay

Connect Razorpay under Settings > Payments to accept online payments through Razorpay's hosted checkout flow. When a customer selects Razorpay at checkout, Nevuto creates a Razorpay order, redirects the customer to Razorpay to complete payment, and verifies the signed payment response when they return to your store.

Before you start

• Sign in as the store owner or with a staff account that has permission to manage Payments. Staff accounts without Payments permission cannot open the Razorpay settings page.
• Have an eligible Razorpay merchant account. Razorpay primarily serves businesses registered in India (and supported international markets); complete Razorpay's KYC and account activation requirements before accepting live payments, and verify that international currency acceptance is enabled on your Razorpay account if you sell in non-INR currencies such as USD.
• Confirm that your store currency is supported by the Razorpay integration. Nevuto supports over 90 currencies for Razorpay, including USD, INR, EUR, GBP, AED, AUD, CAD, SGD and TRY. The USD examples in this guide do not by themselves establish merchant eligibility outside Razorpay's supported regions.
• Generate your test and live API keys under Account & Settings > API Keys in the Razorpay Dashboard.

Open the Razorpay setup

1. In your Nevuto admin, go to Settings > Payments.
2. Click Add payment in the upper-right corner, then select Add payment provider.
3. In the Add payment method modal, enter Razorpay in Enter payment method. Clear any category tab filter if it hides the result.
4. Select the Razorpay card to open its setup form.

If Razorpay is already configured on your store, click its row on Settings > Payments or open its three-dot menu and select Manage. Opening the setup form does not connect or activate Razorpay until you submit valid credentials. Select any screenshot to view it at full size.

Match Razorpay API keys to the Nevuto fields

In your Razorpay Dashboard, switch between Test Mode and Live Mode in the top bar and open Account & Settings > API Keys to generate or copy your Key ID and Key Secret. See Razorpay's API keys guide and Razorpay's API authentication guide for details.

Match your Razorpay credentials to the fields in Nevuto:

• Public key: Your live Razorpay Key ID (starts with rzp_live_).
• Secret key: Your live Razorpay Key Secret.
• Sandbox public key (inside Sandbox mode): Your test Razorpay Key ID (starts with rzp_test_).
• Sandbox secret key (inside Sandbox mode): Your test Razorpay Key Secret.

Configure sandbox mode

1. In the Razorpay setup form under Configure API keys, click Sandbox mode to expand the test fields.
2. Paste your test Key ID (rzp_test_...) into Sandbox public key.
3. Paste your test Key Secret into Sandbox secret key. You can leave the live Public key and Secret key fields empty while setting up only sandbox testing.
4. Turn on Enable sandbox mode so Nevuto uses your test credentials.
5. Turn on Enable payment status when you want Razorpay shown at checkout during testing.
6. Review Payment Limits if you want to restrict Razorpay by cart total.
7. Click Submit in the upper-right corner and wait for the confirmation toast.

When you click Submit, Nevuto checks the active mode's Key ID and Key Secret against Razorpay before saving. On a successful first save, Nevuto returns to Settings > Payments. Reopen Razorpay to confirm that your keys and mode were saved.

In the Payments list, Active or Inactive indicates whether customers see Razorpay at checkout, while Sandbox or Live shows which credential pair is active.

This screenshot shows an unsaved example. All four credential fields are intentionally empty and Enable payment status is off. Enter your own Razorpay test Key ID and Key Secret before clicking Submit.

Test the customer payment flow

After saving your sandbox configuration, test the complete checkout redirect and return path before switching to live keys. Review Razorpay's test card and payment details for official test card numbers and simulated authentication flows. Never enter a real card in sandbox mode.

To run your own merchant test after saving sandbox credentials:

1. Add a product to your storefront cart in a supported currency (such as USD or INR) and proceed to checkout.
2. Select Razorpay as the payment method and continue to Razorpay's hosted checkout page.
3. Enter one of Razorpay's official test cards and choose Success on Razorpay's simulated bank authentication page.
4. Wait for Razorpay to redirect back to your store and verify that the order is marked as paid in Nevuto.
5. In your Razorpay Dashboard (with Test Mode selected), open Transactions > Payments and confirm that the test payment is recorded as captured and matches the Nevuto order amount.
6. Run a second test where you cancel the checkout or choose Failure on the simulated bank page to confirm that failed or cancelled attempts return to checkout without marking the order as paid.

A saved configuration or Active badge only confirms that the key pair passed the initial connection check; always verify a complete test order and return flow before going live.

Set payment limits

Use Payment Limits to control the cart totals for which Razorpay is offered at checkout. Turn on the Payment Limits switch and enter a Minimum Cart Amount and Maximum Cart Amount in your store currency. The minimum amount cannot exceed the maximum amount.

Switch to live payments

After verifying your test checkout flow and confirming that your Razorpay account is activated for live payments:

1. In your Razorpay Dashboard, switch from Test Mode to Live Mode and open Account & Settings > API Keys to copy your live Key ID (rzp_live_...) and Key Secret.
2. In Nevuto, open Settings > Payments and select Razorpay.
3. Paste your live Key ID into Public key and your live Key Secret into Secret key.
4. Expand Sandbox mode and turn off Enable sandbox mode.
5. Confirm Enable payment status and Payment Limits are set as intended.
6. Click Submit and verify that Settings > Payments lists Razorpay as Active in Live mode. Reopen Razorpay to confirm your live keys are stored.

Your test keys can remain in the sandbox fields; turning off Enable sandbox mode switches Nevuto to your live credentials.

Edit or deactivate Razorpay

Open Razorpay from Settings > Payments (or select Manage from the row's three-dot menu ) any time you need to rotate API keys, switch modes or update cart limits. Submit stays disabled until you change a field on the form.

To stop offering Razorpay at checkout without deleting your keys, turn off Enable payment status and click Submit, or open the three-dot menu on the Razorpay row in Settings > Payments and choose Deactivate. Choosing Delete from the three-dot menu removes the saved Razorpay configuration from your store. Deactivating or deleting Razorpay only affects new checkouts and does not cancel or refund past orders. Because Nevuto does not process Razorpay refunds from the order screen, issue any post-payment refunds directly from your Razorpay Dashboard.

Troubleshooting