Connect Razorpay

Take UPI, cards, net banking, wallets and EMI through your own Razorpay account - step by step, from API keys and the webhook to a test payment and going live.

Razorpay lets customers pay by UPI, cards, net banking, wallets and EMI, and it also takes international cards. It works for invoices from every Ellibo app, POS bills, bookings, and subscriptions - including automatic payments (cards, UPI Autopay and e-mandates).

Before you start

• A Razorpay account. Sign up at razorpay.com. Test mode works straight away; Live mode needs your KYC (PAN, business proof, bank account) and your website or app details, which Razorpay checks, usually within a few working days.
• You must be an admin of the business in Ellibo.

Step 1: Get your API keys

1. Sign in to the Razorpay Dashboard.
2. At the top, choose Test Mode (to try first) or Live Mode.
3. Go to Account & Settings › API Keys (under Website and app settings).
4. Click Generate Key (or Regenerate).
5. Copy the Key Id (starts with rzp_test_ or rzp_live_) and the Key Secret.

Step 2: Connect in Ellibo

1. Open Settings › Integrations › Payments.
2. On the Razorpay tile, click Connect.
3. Fill in the form:

Ellibo checks the keys with Razorpay. You see Razorpay is connected - with in TEST mode when you used test keys.

Step 3: Add the webhook

The webhook tells Ellibo the moment a customer pays.

1. In Ellibo, under Your gateways › Razorpay, click Copy next to Webhook URL.
2. In the Razorpay Dashboard (same mode as your keys), go to Account & Settings › Webhooks › + Add New Webhook.
3. Webhook URL: paste the address.
4. Secret: type a password of your own (not your API Key Secret). Write it down.
5. Active Events: tick payment_link.paid, payment.captured and payment.failed.
6. Click Create Webhook.
7. Back in Ellibo, click Keys on Razorpay, paste the same secret into Webhook secret, and click Save. The webhook now shows Secret saved.

Step 4: Try a test payment

1. Make a small invoice for yourself and open its Pay now link.

2. Choose Razorpay and pay with one of Razorpay's test details:

   • UPI: success@razorpay (or failure@razorpay to try a failed payment);
   • Card: 4100 2800 0000 1007 (Visa), any future date, any CVV, and any 4-10 digit OTP.
3. The invoice shows Paid in Ellibo within seconds.
4. Cancel the test receipt in Accounting afterwards.

Step 5: Go live

1. Finish activation in Razorpay until your account shows as activated.
2. Switch the dashboard to Live Mode and generate live API keys.
3. In Ellibo, click Keys on Razorpay, paste the live Key Id and Key Secret, and Save.
4. Add the webhook again in Live Mode (webhooks are separate for test and live), and paste its secret.

Fees, payouts and refunds

• Razorpay charges a fee per payment; see their pricing page. Ellibo adds nothing.
• Payouts reach your bank on Razorpay's schedule, usually two working days after payment (T+2). Record them in Accounting › Online Payments - see Payouts and refunds.
• Refund from Ellibo with the Refund button; the money goes back through Razorpay.
• Subscriptions can charge customers automatically through Razorpay - see Automatic payments.

If something goes wrong

See also Fix payment problems.