All Integrations
Razorpay

Razorpay Integration

Power your ArchCenter subscription billing with Razorpay — plan activation, renewals, and referral rewards are all handled automatically via webhooks.

Overview

Razorpay is used by the SuperAdmin to configure subscription plans for firms. Individual firm admins do not configure Razorpay — they simply choose a plan from the Billing page and are taken to the Razorpay checkout.

Checkout
Firm chooses a plan and pays via Razorpay's hosted checkout.
Webhook
Razorpay fires subscription events to ArchCenter to activate and renew plans.
Referrals
On subscription.activated, both the referrer and referred firm get +30 days.

Prerequisites

  • A Razorpay account with KYC completed (required for live mode)
  • SuperAdmin access to ArchCenter
  • Your app must be publicly accessible for Razorpay webhooks to reach it

Step 1 — Get your Razorpay API Keys

  1. 1Log in to your Razorpay Dashboard.
  2. 2Go to Settings → API Keys and generate a key pair. Copy the Key ID and Key Secret.
  3. 3Use Test Mode keys during development and switch to Live Mode when ready.

Step 2 — Create Subscription Plans in Razorpay

  1. 1Go to Products → Subscriptions → Plans and create a plan for each tier (e.g. Starter, Professional, Enterprise).
  2. 2Set the interval to monthly and the amount in paise (₹999 = 99900 paise).
  3. 3Copy each plan's Plan ID (starts with plan_).

Step 3 — Configure the Webhook

  1. 1In Razorpay Dashboard, go to Settings → Webhooks and click Add New Webhook.
  2. 2Set the Webhook URL to:
    https://your-domain.com/billing/webhook
  3. 3Set a Secret (any random string — keep it safe).
  4. 4Subscribe to these events: subscription.activated, subscription.charged, subscription.cancelled.
  5. 5Click Create Webhook.

Step 4 — Save in SuperAdmin Settings

  1. 1Log in to /superadmin and go to Settings.
  2. 2Enter your Razorpay Key ID, Key Secret, and Webhook Secret.
  3. 3In config/plans.php, add each plan with its Razorpay plan_id from Step 2.
  4. 4Click Save. Firms can now subscribe from the Billing page.

Test vs Live mode

Use Razorpay Test mode credentials during development — no real money is charged. Use the test card 4111 1111 1111 1111 with any future expiry and any CVV. Switch to Live keys only when you're ready to accept real payments.