How to connect Razorpay to accept online fee payments
For school accountants and principals turning on online fee collection for the first time. By the end, parents will be able to pay invoices over UPI, cards, NEFT, and wallets directly into your school's Razorpay account, with every payment auto-posted back into Inkwelly as a settled receipt.
To connect Razorpay in Inkwelly: sign in to dashboard.razorpay.com and generate API keys, copy the Key Id and Key Secret, open Inkwelly → Settings → Online payments, paste both into API Keys, save to receive your Webhook URL and Secret, register that webhook in Razorpay with six events, then pick whether the school or parents pay the gateway fee. The whole setup takes about 15 minutes.
Razorpay is the most widely used payment gateway in Indian schools and is the only provider Inkwelly integrates with directly. Razorpay's published rates are around 2% on cards, around 0.5% on UPI for amounts above ₹2,000, and 0% on UPI up to ₹2,000 because of the NPCI zero-MDR rule for low-ticket peer-to-merchant collections. A school of 1,200 students with an average annual fee of ₹40,000 moves roughly ₹4.8 crore a year — even a 1% blended gateway fee is around ₹4.8 lakh, so the convenience-fee choice is a real P&L line, not a footnote. Keys saved in Inkwelly are encrypted at rest with AES-256 and never logged in clear after the first save.
1. Open Online payments in Inkwelly Settings
From the Inkwelly school sidebar, open Student Fee → Configuration, then click the Payment Gateway tile under Integrations. The tile takes you to the school-wide Online payments page at Settings → Payment gateways. The same page is reachable directly from Settings → Online payments — both routes land on the four-section setup wizard with a left sidebar listing Account, API Keys, Webhooks and Convenience fee.
2. Generate API keys in your Razorpay dashboard
In a new browser tab open dashboard.razorpay.com and sign in. Use the toggle in the top-right to switch to Test mode for piloting or Live mode once Razorpay has activated your KYC. From the left sidebar, expand Account & Settings and click API Keys. Click Generate Test Key (or Generate Live Key). Razorpay shows the Key Id and Key Secret exactly once on screen — copy both into a temporary note immediately. If you close that screen without copying the secret, you will have to regenerate the pair and start again.
3. Fill the Account section in Inkwelly
In the Inkwelly Online payments page, the Account section is open by default on first setup. Enter a display name that the office will recognise on every receipt and audit log — for example AVM Group Razorpay (Live). Pick the matching mode — Test for piloting, Live for real money. Keep Active toggled on so the gateway is eligible to receive payments. Mode and key prefix have to match: a Test key is rejected in Live mode and vice versa, so set them together.
4. Paste Key Id and Key Secret into API Keys
Click API Keys in the left sidebar. Paste the Razorpay Key Id into the first field — it must start with rzp_test_ for Test or rzp_live_ for Live, otherwise Inkwelly refuses to save. Paste the Razorpay Key Secret into the second field. Inkwelly encrypts the secret with AES-256 the moment you click Connect Razorpay; it is never written to logs, audit trails, or exports in clear text. Click Connect Razorpay at the bottom right. Inkwelly creates the gateway account and immediately generates a Webhook URL and Webhook Secret for the next step.
5. Register the webhook in Razorpay
Click Webhooks in the Inkwelly sidebar. Copy the Webhook URL and Webhook Secret using the Copy buttons. In your Razorpay tab, open Settings → Webhooks (direct link: dashboard.razorpay.com/app/webhooks) and click Add New Webhook. Paste the URL into Webhook URL and the Secret into the Secret field. Tick the six active events Inkwelly listens for: payment.captured, payment.failed, refund.processed, payment_link.paid, payment_link.cancelled, and payment_link.expired. Enter an alert email so Razorpay warns you if delivery starts failing. Confirm the webhook mode matches your keys — Live mode webhook for Live keys — and click Create Webhook. Razorpay fires a test ping immediately; if the credentials are correct the webhook shows Active.
6. Pick who pays the gateway fee
Click Convenience fee in the Inkwelly sidebar. Choose between two options. Parent pays grosses up every invoice so the school nets the full fee — for example a ₹1,000 invoice with 2% becomes ₹1,020 at checkout and the school still settles exactly ₹1,000. School absorbs leaves the parent paying exactly the invoice amount, and the school settles for invoice minus Razorpay's fee. Most Indian schools pick Parent pays at 2% to keep collections at face value. For Parent pays, set a single Convenience fee rate between 0 and 10 percent that covers Razorpay's blended cost across cards and UPI. Click Save changes.
7. Run Test connection and check the Status section
Click Status in the sidebar. Click Test connection. Inkwelly makes a single read-only call to Razorpay using your saved credentials; if the call succeeds, the card flips to green with Razorpay credentials verified and a Last verified at timestamp. If the call fails, Razorpay's reason is shown verbatim — common causes are a wrong mode-key combination, a regenerated secret that was not updated in Inkwelly, or a deactivated Razorpay account. Fix the underlying issue, re-save, and rerun Test connection until the badge turns green.
Once online payments are live, the next step is to confirm a real payment lands back as a receipt — follow How to reconcile an online payment received through Razorpay in Inkwelly to see the auto-post flow and the Mark as reconciled action for any payment that falls into Awaiting confirmation. At month end, pull the gateway charges report using How to download the Gateway Charges (Razorpay MDR) report in Inkwelly so the MDR and GST per transaction are accounted as a separate P&L line.
See Inkwelly Student Fees in action
अक्सर पूछे गए सवाल
7 सवालHow does Inkwelly connect to Razorpay for fee payments?
Inkwelly stores your Razorpay Key Id and Key Secret per school, encrypted with AES-256 at rest. When a parent pays an invoice, Inkwelly creates a Razorpay Order using those keys; Razorpay then collects over UPI, cards, NEFT, IMPS, or wallets and notifies Inkwelly via the webhook events you registered. The money settles directly into your school's Razorpay-linked bank account, not through Inkwelly.
Razorpay kaise connect kare Inkwelly se?
Pehle dashboard.razorpay.com par sign in karke API Keys generate kijiye — Test mode me rzp_test_ wala Key Id aur Key Secret milega, Live mode me rzp_live_. Inkwelly me Student Fee → Configuration → Payment Gateway tile open kijiye, ya direct Settings → Online payments par jaiye. Account section me display name aur mode chuniye, API Keys section me dono fields paste kijiye, Connect Razorpay dabaiye. Phir Webhooks section se URL aur Secret copy karke Razorpay ke Settings → Webhooks me register kijiye, chhe events tick kijiye, aur Convenience fee section me decide kijiye kaun gateway fee uthayega.
Convenience fee parent ya school deta hai?
Yeh aapki choice hai. Inkwelly Convenience fee section me do options deta hai. Parent pays select karne par invoice ka amount checkout par badh jaata hai — jaise ₹1,000 ka invoice 2% ke saath ₹1,020 ho jata hai, aur school ko poora ₹1,000 milta hai. School absorbs select karne par parent invoice ka exact amount deta hai, aur school ko gateway fee ke baad bachi rakam milti hai. Aam tor par CBSE aur state board schools 2% Parent pays choose karte hain kyunki collection ka face value bana rehta hai.
Does Inkwelly support UPI Autopay or only one-time UPI payments?
Inkwelly currently supports Razorpay's standard Checkout flow and Payment Links — both cover UPI, cards, NEFT, IMPS, and wallets as one-time payments. UPI Autopay-style mandates (auto-debit on every installment due date) are on the roadmap and need Razorpay to enable subscription mandates on your account. For now the parent receives a fresh payment link per installment over WhatsApp, SMS, or email.
What does Razorpay charge per transaction for school fees?
Razorpay's published rates for the standard Checkout plan are around 2% per transaction on Indian credit and debit cards, around 0.5% on UPI for amounts above ₹2,000, and 0% on UPI for amounts up to ₹2,000 because of NPCI's zero-MDR rule for low-value person-to-merchant payments. Net banking and wallets are around 1.5% to 2%. GST at 18% applies on the gateway fee. Always check the latest pricing under your Razorpay dashboard's Pricing page since rates do shift.
What happens if I lose the Razorpay Key Secret after saving it in Inkwelly?
Razorpay shows the Key Secret exactly once on screen and never lets you fetch the same secret again. Inkwelly stores its own encrypted copy at save time, but if Razorpay revokes or rotates the key, you have to regenerate the key pair in dashboard.razorpay.com → Account & Settings → API Keys and paste the new pair into Inkwelly's API Keys section. The Key Secret field in Inkwelly stays masked after save; you only re-enter it when you are rotating credentials.
How quickly does an online payment show up as a receipt in Inkwelly?
Within a few seconds, provided the webhook is registered correctly. Razorpay calls Inkwelly's Webhook URL with payment.captured the moment the parent's bank confirms the debit; Inkwelly verifies the webhook signature against your Webhook Secret, marks the invoice paid, generates a receipt, and triggers the receipt-sent notification. If the webhook is missing or misconfigured, the payment will stay in Awaiting confirmation in Payments and you will need to use Mark as reconciled to close it manually.
आपको ये भी पसंद आ सकता है
3 लेखस्रोत व संदर्भ
- Razorpay Documentation — API Keys and Webhooks · देखा गया 19 May 2026
Razorpay's official guidance that the Key Secret is shown exactly once during generation and must be stored securely, and that webhooks are the primary post-payment notification channel.
- Reserve Bank of India — Payment and Settlement Systems regulations on MDR · देखा गया 19 May 2026
RBI's regulatory framework for merchant discount rate (MDR) on card and digital payments, under which Razorpay's per-transaction pricing is published.
- National Payments Corporation of India — UPI Zero MDR notification · देखा गया 19 May 2026
NPCI's circular that mandates zero merchant discount rate on UPI person-to-merchant transactions up to ₹2,000, which is why low-value UPI fee collections incur no gateway fee.
Inkwelly आपके स्कूल पर — खुद देखें
30 मिनट का डेमो। आपके मौजूदा ERP को आपके साथ खोलकर, कॉल पर ही आपका डेटा Inkwelly में लोड करते हैं। कॉल ख़त्म होते-होते एक तय तारीख़ का गो-लाइव प्लान आपके हाथ में।