local-testing

Local Razorpay Testing Guide

Complete guide to testing your Razorpay integration locally before touching production.

Step 1: Get Test API Keys

1. Go to Razorpay Dashboard
2. Toggle to Test Mode (top-left switch)
3. Go to Settings → API Keys → Generate Key
4. You'll get:
   • rzp_test_xxxxx — Key ID
   • A secret — Key Secret (shown once, save it)

Update .env.local:

RAZORPAY_KEY_ID=rzp_test_xxxxx
RAZORPAY_KEY_SECRET=your_test_secret
NEXT_PUBLIC_RAZORPAY_KEY_ID=rzp_test_xxxxx

Test keys start with rzp_test_, live keys with rzp_live_. They access completely separate environments — test data is invisible in live mode and vice versa.

Step 2: Create Test Plans

Plans must exist before you can create subscriptions. Create them in test mode:

curl -u rzp_test_xxxxx:your_test_secret \
  https://api.razorpay.com/v1/plans \
  -H "Content-Type: application/json" \
  -d '{
    "period": "monthly",
    "interval": 1,
    "item": {
      "name": "Pro Plan Monthly",
      "amount": 99900,
      "currency": "INR",
      "description": "Pro plan billed monthly"
    }
  }'

Save the returned plan_id (e.g., plan_test_xxxxx) in your .env.local:

RAZORPAY_PLAN_MONTHLY=plan_test_xxxxx

Test and live plans have different IDs. You need separate plan IDs per environment.

Step 3: Set Up ngrok for Webhooks

Razorpay can't reach localhost. You need a public tunnel.

Install ngrok

# macOS
brew install ngrok

# or download from https://ngrok.com/download
# Sign up for free account and add authtoken
ngrok config add-authtoken your_token

Start the tunnel

# Start your app first
npm run dev   # localhost:3000

# In another terminal, start ngrok
ngrok http 3000

ngrok gives you a URL like https://abc123.ngrok-free.app. This is your public URL.

Keep ngrok running throughout your testing session. If you restart ngrok, you get a new URL and must re-register the webhook.