Setting Up Razorpay in Node.js Account Creation, SDK Installation, and Configuration

Setting Up Razorpay in Node.js

This guide covers creating a Razorpay account, getting API keys, and configuring the Razorpay client in your Node.js application.

Step 1: Create a Razorpay Account

1. Go to https://razorpay.com
2. Click "Sign Up"
3. Enter your email, phone, and business details
4. Complete KYC verification (required for live mode)
5. Once approved, you get access to the dashboard

Step 2: Get API Keys

1. Go to Razorpay Dashboard → Settings → API Keys
2. Generate a new key pair:
   • Key ID: rzp_test_XXXXXXXXXX (test) or rzp_live_XXXXXXXXXX (live)
   • Key Secret: xxxxxxxxxxxxxxxxxxxxxxxx
3. Save securely the secret is shown only once

Step 3: Install the Razorpay SDK

npm install razorpay

Step 4: Configure Razorpay Client

// src/config/razorpay.js
const Razorpay = require("razorpay");

const razorpay = new Razorpay({
  key_id: process.env.RAZORPAY_KEY_ID,
  key_secret: process.env.RAZORPAY_KEY_SECRET
});

module.exports = razorpay;

Step 5: Add Environment Variables

# .env
RAZORPAY_KEY_ID=rzp_test_XXXXXXXXXX
RAZORPAY_KEY_SECRET=xxxxxxxxxxxxxxxxxxxxxxxx
RAZORPAY_WEBHOOK_SECRET=xxxxxxxxxxxxxxxxxxxxxxxx

Step 6: Test the Configuration

// Create a test order
const razorpay = require("./config/razorpay");

const testOrder = async () => {
  try {
    const order = await razorpay.orders.create({
      amount: 50000, // ₹500.00 (in paise)
      currency: "INR",
      receipt: "test_receipt_001"
    });
    console.log("Test order created:", order);
  } catch (err) {
    console.error("Razorpay error:", err);
  }
};

testOrder();

Razorpay Amount Format

Razorpay uses the smallest currency unit:

• INR: paise (₹1 = 100 paise)
• USD: cents ($1 = 100 cents)

// ₹500.00
amount: 50000  // 500 × 100 = 50000 paise

// ₹99.99
amount: 9999   // 99.99 × 100 = 9999 paise

Test vs Live Mode

Test cards:

• Card number: 4111 1111 1111 1111
• Expiry: Any future date
• CVV: Any 3 digits

The Takeaway

Setting up Razorpay involves: creating an account and completing KYC, getting API keys (key_id and key_secret) from the dashboard, installing the razorpay npm package, configuring the Razorpay client in a config file, adding keys to .env, and testing with a small order creation. Remember that amounts are in paise (₹1 = 100 paise). Use test mode for development and live mode for production.