Razorpay Settings
The Razorpay page connects a business unit to its own Razorpay account, so your customers can pay invoices online through a payment link. Each payment is recorded as a receipt against the invoice, and each Razorpay settlement is booked to your bank.
This is the only place your Razorpay keys are entered. It is set per business unit.
Only your organisation's own admins can open this page and make changes. Bizconnekt staff can't open it for you, and Neo can't change it.
Before you start: Razorpay must be switched on for the business unit
Razorpay is switched on for a business unit by the Bizconnekt team. Until it is, the page shows "Razorpay is not enabled for this business unit." and "Online payment collection is not enabled for this business unit." You can see the settings, but you can't change them.
While Razorpay is off for a business unit, nothing to do with it appears in the web app — it is hidden, not greyed out:
- no Collect payment action on invoices
- no Online Payment tab on an invoice
- no Online Payments list under Payments Received
- no Payment Request email templates
How do I open it?
In the Admin console, open Configuration → Finance → Razorpay. Online payments are set up in the Collect payments online section.
Setting up online payments
Follow these steps in order. Each one is saved on its own.
1. Choose where payments are booked, then connect
| Setting | What to pick |
|---|---|
| Razorpay clearing ledger | A Bank ledger that holds the money between the customer's payment and Razorpay's settlement |
| Bank ledger | The bank account Razorpay settles into. It must be a different account from the clearing ledger |
| Fee expense ledger | The expense ledger Razorpay's fee is booked to |
| How Razorpay's fee is booked | Book the fee from each settlement, or Book the fee from Razorpay's monthly invoice (see below) |
| GST on Razorpay's fee | Shown for the per-settlement option only: Automatic (from this business unit's state), CGST + SGST, or IGST |
| Razorpay fees payable ledger | Shown for the monthly-invoice option only, where it is required: a Bank ledger that holds the fee until you pay Razorpay's monthly invoice |
| Payment links expire after (days) | The default offered when a link is sent — 1 to 30 days. It starts at 15 |
| Let customers pay part of the amount | The default for new links. It can be changed on each link |
The ledger lists come from your chart of accounts. The clearing, bank and fees-payable lists show Bank accounts only, and the fee expense list shows expense accounts only.
Click Save and connect. This connects the business unit to Razorpay and shows the Webhook URL you need in the next step. You can connect before every ledger is picked — all three main ledgers are only required once online payments are switched on.
- Book the fee from each settlement — the fee and its GST are booked from each settlement. Do not also enter Razorpay's monthly invoice as a bill, or the fee is counted twice.
- Book the fee from Razorpay's monthly invoice — each settlement parks the fee in the fees payable ledger. Enter Razorpay's monthly tax invoice as a supplier bill and pay it through that ledger.
2. Set up the webhook in Razorpay
- Copy the Webhook URL with the Copy button.
- In the Razorpay Dashboard, go to Webhooks and add it, with the events payment_link.paid, payment_link.partially_paid, settlement.processed, refund.created and payment.dispute.created.
- Back on this page, paste the secret you set on that Razorpay webhook under Webhook secret, and click Save secret.
The webhook secret works as soon as it is saved, and it is never shown again.
3. Add your Razorpay keys
Take these from the Razorpay Dashboard, under Account & Settings → API keys:
| Field | Looks like |
|---|---|
| Key id | rzp_live_… or rzp_test_… |
| Key secret | The secret Razorpay gave you with the key id |
| Razorpay account id | acc_… |
Click Save keys. Bizconnekt checks the keys with Razorpay before saving them. If Razorpay refuses them, you see "Razorpay refused these keys — check the key id and secret" and nothing is saved.
Once saved, a key secret is never shown again — the page shows only the last four characters of the key id. New keys take effect only after the key-change delay (48 hours unless you change it), and every admin is emailed about them.
4. Switch online payments on
Click Switch on. Bizconnekt refuses until the business unit has:
- the clearing, bank and fee expense ledgers picked
- a set of keys that is waiting or in use
- a webhook secret that has not been revoked
- a posting key (issued automatically when you connect)
The status line then reads Online payments: On.
Pausing online payments
Click Pause and confirm. While paused:
- no new payment links can be sent
- links already sent stay payable until they expire, and their payments are still recorded
Every admin is emailed. Click Switch on to resume.
Changing keys safely
The key-change delay
New keys never take effect straight away. They wait out the Delay before new keys take effect (hours), which can be set from 24 to 168 hours.
- A longer delay applies at once.
- A shorter delay first waits out the current one, and every admin is emailed a link to block it.
Click Save delay after changing it.
Blocking a change you didn't make
When new keys or a shorter delay are waiting, the page shows "A change is waiting to take effect", with who made it and when it takes effect. Any admin can click Block there, or use the Block link in the email every admin receives. A blocked change never takes effect.
If an admin you don't trust made the change, also remove their admin access in Users.
Key statuses and actions
| Status | What it means | What you can do |
|---|---|---|
| Waiting | Saved, waiting out the delay | Block or Retire |
| In use | Used for new payment links | Retire |
| Blocked | Stopped before it took effect | Retire |
| Retired | No longer used | — |
| Retired (keys removed) | Retired, and the keys have since been removed | — |
Retire takes effect at once and cannot be undone: new payment links stop using those keys, and open links made with them are cancelled. Every admin is emailed.
Revoking a webhook secret
Click Revoke next to a secret. Razorpay notifications signed with it are no longer accepted, so make sure your Razorpay webhook uses another saved secret first. While online payments are on, you can't revoke your last secret — save a new one first.
Posting key
Receipts for online payments are posted with a posting key that Bizconnekt issues when you connect. If receipts stop posting because the key was rotated or stopped working, click Re-issue posting key and confirm. Every admin is emailed. It is safe to repeat.
Checking that payments are arriving
Under Payment events the page shows:
- when the last payment event was received from Razorpay (it looks back 40 days)
- the latest error, if any
- a warning if a delivery failed its signature check — check that the webhook secret in Razorpay matches the one saved here
Refunds and disputes raised in Razorpay are never posted automatically — record them by hand.
The "Record Razorpay payments in these books" section
The Razorpay section at the top of the page is used only for business units the Bizconnekt team has connected to its own payment server. Once Razorpay is on, any other business unit sees "Saved settings are used only for business units the platform team has connected." Anything saved there is not used, and it does not affect collecting payments online.