Payment Methods
Online and offline payment options available to your patients.
Payment Methods
Payment methods define how patients pay for appointments and services. Methods are tenant-configurable — each hospital decides which payment options are available.
Tenant-Configurable Payment Methods
Payment methods are stored in the tenant configuration as a list. Each method has:
Field | Description |
|---|---|
Code | Machine-readable identifier (e.g., CASH, CARD, UPI, CHEQUE) |
Label | Display name shown to users |
Active | Whether this method is currently available |
Sort Order | Display order in the payment method selector |
When recording a payment against a bill, the selected payment method must be one of the tenant's active methods. Using a disabled or unlisted method will be rejected.
Payment Types for Appointments
Each appointment can be configured with one of these payment types:
Type | Description |
|---|---|
NONE | No payment required to confirm the appointment |
TOKEN | A fixed token/deposit amount must be paid upfront |
ADVANCE | A percentage of the consultation fee is required upfront |
FULL | The entire consultation fee must be paid before confirmation |
The payment type is determined by the appointment configuration hierarchy — it can be set at the tenant, centre, department, or doctor level. The most specific configuration wins.
Online Payment Integration
For online payments, the system integrates with Razorpay:
- Payment Links: generate shareable payment links that patients can use to pay online
- QR Codes: generate QR codes for in-person UPI payments
- Webhook Processing: automatic payment status updates via Razorpay webhooks
- Payment Receipts: auto-generated receipts after successful payment
Online payments create an order in the payment suite. The appointment is linked to this order, and payment status is tracked automatically.
Deposit System
Patients can maintain deposit accounts (advance payments) that can be applied against future bills.
Deposit Fields
Field | Description |
|---|---|
Deposit Amount | Initial amount deposited (in paise) |
Amount Used | How much has been applied to bills |
Amount Refunded | How much has been refunded |
Amount Available | Remaining balance (deposit - used - refunded) |
Deposit Type | Category — tenant-configurable |
Status | ACTIVE, FULLY_USED, CLOSED, or REFUNDED |
Deposit Transactions
Every change to a deposit balance is tracked as a transaction:
- DEPOSIT: initial deposit or top-up
- USAGE: amount applied to a bill — linked to the specific order
- REFUND: amount returned to the patient
When paying a bill, if the patient has an active deposit with sufficient balance, the deposit can be applied. The system reduces the deposit balance and links the transaction to the order.
Refund Processing
Refunds are processed through the payment suite:
- Refund amount is specified in paise
- Refund is processed via Razorpay (for online payments) or recorded manually (for offline payments)
- The system tracks the Razorpay refund ID, status, and amount
- Refund reason is recorded for audit purposes
Last updated on