What you’re looking at
The heading reads Payments Management — “Process and track payments from patients for services, medications, and more”. Refresh and New Payment sit beside it. Six tabs, with Approvals and Credits after Pending (Credits for people who may refund and credit):See your total income in one place
Billing and the Pharmacy till used to be two separate screens, so working out what actually came in meant adding them up yourself. The Total income tab does it for you.Open the tab
Pick the dates
Read it
- Billing. Every payment recorded against an invoice or taken at the desk, on the day it was recorded. A voided payment is left out. So is a payment made with a gift card or with credit: that money was counted when the gift card was sold or the credit was first paid. A record of nothing paid, such as a waived item being closed, is not counted as a payment.
- Insurers. The part of a bill an insurer still owes is not income yet. It counts on the day you record the insurer’s payment, from HMO receivables, and not again when you share that payment across claims.
- Pharmacy POS. What customers paid at the till, and any later instalment on a part-paid sale on the day it was paid. A cancelled sale is left out. A customer paying from their account balance counts when the balance is spent on a sale, not when it was topped up.
- Refunds. Taken off on the day of the refund, under the method the sale was paid with. A refund never reduces income by more than the sale actually took.
- Days. Each day is a day at your clinic, in your clinic’s time zone, so a sale at 11:30 pm is on the day it happened.
Record a payment against an invoice
This is the usual route, because it settles a specific balance.Find the invoice
Check the amount
Choose the method
Add a reference and save
Take a payment with no invoice behind it
New Payment opens a fuller form for money taken at a desk against services rather than a bill.Choose the patient
Pick what is being paid for
Set the method and amount
Process it
Take a walk-in client’s payment
A walk-in lab or imaging client has no patient record, so they are not in the patient search. At the top of New Payment, switch from Patients to Walk-in clients. Search by walk-in number, name or phone — clients who still owe come first — and choose the client. Their unpaid lab tests and imaging orders are listed and ticked; untick anything they are not paying today, choose the method and select Record payment. Select Print receipt to give them a slip. This is the same payment the lab screens take (see Walk-in lab and imaging clients), so a walk-in is never charged twice for an order. You need the Collect payments permission to see the switch. Walk-in clients who still owe also appear in the Pending tab, on the Walk-in clients tab of Pending, with a Walk-in badge and their walk-in number. Process payment on one opens this screen for that client. In the Payments table a walk-in’s payment reads Walk-in · Name (W-000123) with a Walk-in badge, instead of a patient’s name.Reduce what a patient pays (subsidy)
When the clinic subsidises or reduces a charge for a patient, record the amount the patient will actually pay, so the item reads Paid instead of Partially paid or Pending.Tick the item and choose Reduced amount
Enter what the patient will pay, and why
Process the payment
- Some categories, such as Other, need a written reason of at least 10 characters. Under Reason (required) the panel counts how many more characters are needed, and the buttons point at that message until the reason is long enough.
- The amount must be less than the charge and no less than anything already paid on the item. To waive a whole unpaid item, choose Request full waiver in the same panel. A full waiver always goes to a second owner or manager (see Approvals); once approved, the item is closed at once: it shows Waived, leaves the pending lists, and nobody needs to record a payment for it. A waiver is only for an item with nothing paid on it. You can reduce one item and charge another in full in the same payment. On Add Services and Consultations, a picked item can be waived too: choose Reduced amount on it, then Request full waiver. On Add Services, any line can be reduced or waived, including a service that is on the payment more than once and a line with a quantity above 1; the reduction is checked against that line’s total. The item is not charged. When you record the payment it is added to the patient’s pending items at its full price and quantity, unpaid, and a second owner or manager must approve the waiver in Payments, Approvals. Until then it stays unpaid. When the waiver is approved the item is closed straight away, with nothing to collect, and a waived consultation puts the patient on that department’s Triage Waiting list, just as a paid one does; if it is rejected it stays unpaid at full price. If only waived items are selected, the button reads Add unpaid and send waiver for approval and no payment or receipt is made. A reduced amount on a picked item that is above your approval percentage (or in a category that always needs a second approver) is handled the same way: the item is not charged, it is added unpaid and the reduced amount waits in Payments, Approvals. The row reads Reduced to the amount you typed, added unpaid, waits for approval. If you are the only owner or manager, you can approve your own request there after confirming it. Once approved, the patient pays the reduced amount from their pending items.
- An item an HMO partly covers is reduced on the patient’s share only. The HMO’s share does not change, so the HMO claim stays correct.
- A subsidy is not money received. The payment total, Total income and the revenue figures count only what was paid. Every reduction — at payment, set before payment, on a price list item, and on an invoice — is listed on its own under Payments in Reduced amounts, with the date, item, where it was given, its category and who gave it. Group the list by category or by where it was given; voided payments are left out. The reason is shown to owners, managers and anyone who holds Apply reduced amounts.
- The receipt says so. The item is marked “Subsidy … — paid in full” and the receipt has a Subsidy line. It is never counted as paid and never leaves a balance due.
- Not with Insurance. A reduced amount cannot be combined with an insurance payment. Choosing Insurance removes any reduction you set.
- To change it before you pay, untick the item. Unticking removes the reduction and the item goes back to its full balance.
- Reduce an item before anyone pays for it. In Reduced amount, choose Save for later instead of applying it. The item then shows Reduced — on its row, and on the patient’s total in the Pending tab — for everyone, and the front desk collects the reduced amount without needing the permission. It stays until the item is paid or someone with Apply reduced amounts removes it; removing it asks for a reason, and the item goes back to its full price.
- File it under a category. Choose a category beside the reason, so the Reduced amounts report can be grouped. While your clinic has categories, a reduced amount without one is not accepted.
Reduce an invoice
Open an invoice’s Record Payment (from Billing → Invoices, Pay Invoice here, or Collect payment on the patient’s billing tab). Anyone with Apply reduced amounts sees Reduced amount against each line of the invoice:- Reduce a line by entering what the patient will pay for it, with a reason. The invoice total goes down by the amount forgone, and the balance with it.
- Reduce the whole invoice by an amount or a percentage. It is spread across the lines in proportion to their price, so your line reports stay accurate. With an HMO on the invoice the amount or percentage is of the patient’s share.
- If the patient has already paid more than the new total, the extra becomes the patient’s credit. Nothing is refunded automatically.
- Take a reduction back with Take back reduced amounts and a reason, while the invoice is not fully paid. The reduction stays in the record. It cannot be taken back once the invoice is fully paid, or after a credit was issued from it.
- The invoice and the receipt show a Reduced amount line with the amount only. The reason is kept inside the clinic.
- A draft invoice is edited directly. Once an invoice has been sent, or has a payment on it, its prices and discount can no longer be edited — every change is a recorded reduced amount.
- A discount needs the same permission and a reason. The Global Discount (%) and each line’s discount on the invoice form are available only to people who hold Apply reduced amounts, and ask for a reason.
Send a payment link instead
If the patient is not in front of you, send a link and let them pay by card.Open the appointment and start a payment
Choose what it covers
Choose who it goes to
Send it
Void a payment taken in error
Open the row’s Actions menu, select Void Payment, and read the dialog before you confirm. It says what will happen:- A payment against an invoice is marked voided and the invoice balance is restored.
- A payment with no invoice (taken at New Payment, from Collect payment on the Lab or Pharmacy list, or a walk-in’s payment) is marked voided, and everything it paid for goes back to unpaid. The dialog names them — for example “the 2 lab tests and 1 medication it paid for will show as unpaid again in Lab, Pharmacy, Imaging and Pending Items”. They can then be paid again, correctly.
Void, refund or credit
Three different things, and the product keeps them apart:Cancel & credit
Open the payment’s Actions menu and choose Cancel & credit. Tick the paid lab test, imaging study, service, medicine that has not been dispensed, or consultation that has not started, give a reason, and confirm. The patient is credited what was actually paid for it (after any reduced amount). A lab test that has been paid offers the same choice when you cancel it from the Lab list. A medicine that was dispensed (take it back through a return), a consultation that has started, or an item that already has a result cannot be cancelled this way, and a walk-in client has no account to hold a credit — void the payment if it was a mistake. A payment from which an item has been credited can no longer be voided as a whole; settle the credit instead. You need the Refund and credit payments permission (owners and managers have it; an owner can give it to a person).The patient’s credit
A patient with credit has a Credit balance card on their billing tab, with its history. You can:- Spend it. In New Payment, a Patient credit method appears whenever the patient has credit. It pays for their own items only, and the payment is refused if the credit does not cover it. Voiding such a payment puts the credit back.
- Refund it. Refund credit records the money paid back, with a reason. Choose Back to the original card (automatic) when the patient paid online by card: pick the card payment and the refund is sent to the card provider, which returns the money to the card the patient paid with. It is recorded as paid out only when the provider confirms it, which can take a few minutes; until then the credit is held for the refund, and if the provider cannot complete it the credit comes back. You can never refund a card payment for more than it took. The other methods (cash, bank transfer, mobile money, card, other) only record that you paid the money back yourself.
- Let it expire. Under Settings → Billing & Plans → Reductions & refunds, Patient credit expiry can make unused credit lapse after 3, 6, 12 or 24 months. It is Never unless you change it. The oldest credit lapses first, the patient’s credit history shows it as expired, and an owner is told when credit is about to lapse within 30 days. Credit that was used or refunded is never affected, and a lapse does not change Total income.
- Transfer it to a family member or guarantor with Transfer to another patient and a reason. Owners and managers only.
Reduction categories
Every reduced amount is given a Category: Staff, Indigent / charity, Goodwill, Price match or Other to begin with. Owners and managers can add, rename and retire categories under Settings → Billing & Plans → Reductions & refunds → Reduction categories. Renaming changes only the name, so earlier figures stay together; a retired category is hidden from new reductions and stays on the ones already given. Other is always available and always needs a written reason of at least 10 characters. A category can carry its own limits: a largest reduction (for example Goodwill no more than 20% of the charge), Always needs a second approver (it then goes to Approvals whatever its size), and Needs an eligibility document. A category with no limits follows the clinic’s default. The limits are checked on the server for a reduced amount typed at New Payment, one saved for later, and one on an invoice. A category that needs an eligibility document cannot be used for a one-off reduced amount; use a patient reduction rule, which holds the document. A reduced amount that needs a second approver is never turned away at the till: the screen says Needs approval, the patient pays the item in full, and the reduction is sent to Approvals automatically. If it is approved, the difference becomes the patient’s credit; if it is rejected, nothing changes. On an invoice line, or a price-list item that is not yet an item on the patient’s account, an approval-sized reduction is still refused, with a sentence saying what to do. The Reduced amounts report shows the category by its current name and can be grouped by it.Approvals
The Approvals tab on the Payments page is one inbox for the requests that need a second owner or manager: a refund above your Refund approval limit, and a reduced amount that takes off more than the percentage you set under Settings → Billing & Plans → Reductions & refunds. Leave either blank for no second approval.- To approve is for owners and managers. Waiting requests come first, newest first, each showing who asked, the kind, the amount, the category and the reason. Approve can carry a note, and you can approve a smaller amount than was asked for, never a larger one. Reject needs a reason, which the person who asked will see. A decision is final; if something should change, the person asks again.
- My requests is for everyone who can ask. It shows your own requests and, read-only, your department’s (the department set on the staff profile as it is today). For a colleague’s request you see who asked, the kind, the amount, the category and the status, but not the reason, the note or the patient. Without a department you see only your own, and the page tells you to ask a manager to set one. A department head gets no approval rights.
- Withdraw a request that is still waiting. Request again starts a new request from one that was rejected, expired or withdrawn, already filled in, so you can change the amount or the reason. Approvers see it follows the earlier one.
- History shows the last 90 days; pick a date range for older ones.
- The requester can never approve their own. If your clinic has no other owner or manager, the owner can approve their own request after confirming, and the record says it was self-approved because no second approver was available. As soon as another owner or manager exists, the two-person rule applies again.
- While a reduced amount waits, the item stays at full price and can be paid. If a reduced amount is sent for approval from New Payment together with a full payment, approving it turns the difference into the patient’s credit. If the item is paid in full later, by a separate payment, the request is closed as withdrawn with the note “Line paid in full before approval”: it leaves the approvers’ list, and the person who asked can see it under My requests. A part-payment does not close it. If it is rejected, nothing changes.
- Patient rules and waivers come here too. A patient reduction rule above your approval percentage (or a fixed-amount rule, when you have set a percentage, or a 100% rule) shows as a Patient rule, and a request for a full waiver shows as a reduced amount of the whole charge. Neither does anything until it is approved.
- You are told. Owners and managers see a count beside Payments in the menu while requests wait, get a notice in the app, and an e-mail that says a request is waiting without naming the patient or the amount. Turn the e-mail off with the clinic’s notification settings for billing.
- A request nobody decides expires after the number of days set under Settings → Billing & Plans → Reductions & refunds (7 by default). Approvers are reminded after two days, and the person who asked is told when it expires. Owners and managers see what is waiting on the home dashboard, and the person who asked is notified when a request is decided.
Patient reduction rules
A reduction rule gives one patient an automatic reduction: what it covers (all items, consultations, lab tests, pharmacy, services or radiology), a percentage or a fixed amount off each item, a start and an end date, a category and a reason. Open the patient’s Billing tab and choose Add rule under Reduction rules.- It applies by itself. New items in scope are reduced when they are paid, and New Payment, Pending and the front desk show a Reduction rule badge with the terms and the end date. The badge never shows the reason.
- The best one wins. If an item has both a reduction set on it and a rule, only the larger reduction applies. Reductions never stack. An HMO’s share of an item is never reduced.
- Items that were already waiting. When you save a rule, the patient’s unpaid items in its scope are listed with tick boxes. Ticked ones get the reduction; the others are left out of the rule for good. Items already paid never change.
- It ends on its end date, or when you remove it (a reason is required). Removing it stops it for new items only.
- A rule that needs a second approver (see Approvals) waits there and does nothing until it is approved.
- A fixed amount is compared as a percentage of the list price. ₦5,000 off a ₦10,000 consultation counts as 50%, and is checked against your approval percentage the same way a percentage rule is; an amount equal to or above the price counts as 100% and always needs a second approver. When what the rule covers has no single list price (All items, or lab tests, services or medicines that are priced differently), the percentage cannot be known, so a fixed-amount rule goes to a second owner or manager whenever your clinic has an approval percentage set.
- Eligibility. A rule can carry a note and can require a document. It then applies only while a verified, unexpired eligibility document is attached; until then the badge says it is paused and why.
Reduction templates
Under Settings → Billing & Plans → Reductions & refunds → Reduction templates, owners and managers can save ready-made rules, such as “Staff family, 20% on everything for a year”: a name, what it covers, the percentage or amount, how many days it runs, a category and whether it needs a document. Staff then choose the template in Add rule and the terms fill in.- Staff can lower or shorten, never raise. Changing a template’s terms needs a reason, which is kept with the rule. Raising the amount, lengthening the dates or widening what it covers needs an owner or manager.
- Editing or retiring a template never changes rules already given. Each shows how many patients use it. Retiring only hides it from new use. An owner or manager can choose Update existing rules to bring them up to the template’s current terms, with a reason; each rule keeps its own record of the change.
- Anything above your approval percentage still needs a second owner or manager.
Eligibility documents
A rule, or a category, can require an eligibility document such as an ID or a letter. From a rule that needs one, choose Add eligibility document.- Kept apart. Documents are not part of the patient’s clinical record or their files list. Only owners, managers and people with Apply reduced amounts can see or open them, and every time one is opened it is recorded.
- A second person checks it. The person who adds a document can never verify it. Another owner, manager or person with Apply reduced amounts chooses Verify or Reject (a reason is required, and the person who added it sees it). The rule applies only once the document is verified.
- Expiry. A document can have an expiry date. When it passes, the rules relying on it pause: new items get no reduction, and you are asked for a new document. Items already paid never change.
- Files can be PDF, JPEG or PNG, up to 10 MB.
- How long they are kept. A document is deleted one year after the last rule using it ends (a document no rule used, one year after it was added). The deletion is recorded as a count only.
- Export. A data export lists each document’s kind, status and dates, not the file itself.
The Credits tab
The Credits tab on the Payments page (for owners, managers and anyone with Refund and credit payments) lists every patient who holds credit, largest first, with the total held and, if you have set credit to expire, how much lapses within 30 days. Below it, Refunds made lists the credit paid back in a period you pick. Export CSV saves either list; names that look like a spreadsheet formula are saved as plain text. Select View credit on a patient’s row to open a panel with their Credit balance, how much Expires within 30 days (when credit expires), when credit was Last credit added, and their credit History, newest first, with the date, what happened, who did it and the amount. The panel also lists the patient’s refund requests with their status. People who may refund and credit can choose Refund credit or Transfer to another patient there; Open full billing shows the patient’s invoices, payments and credit in a panel over the Payments page; it does not open the patient’s record. Opening the panel is recorded in the audit log.Refunds in your figures
Cancelling and crediting does not change Total income by itself — the cash is still with you. A payment made with credit is not counted again as income. When credit is refunded, Total income goes down by that amount and says so under Billing; a card refund counts once the card provider has confirmed it. Every income figure follows the same rule: a voided payment, a payment made with credit and a payment made with a gift card are not income (a gift card counts when it is sold), a record of nothing paid is not counted as a payment, and a refund is money going out. That covers Total income, the dashboard cards, Payments by Method, the executive overview, the revenue forecast and the reports.Who can do this
Role decides whether Payments opens; an owner sets that per role under Settings → Role Navigation. Once Payments opens, almost nothing narrows further:Check it worked
- The payment is under Payments with your name in Received By, the method and your reference.
- The invoice reads Paid, or Partially paid with the correct remaining balance.
- The Pending tab no longer lists that balance.
- A voided payment is struck through and badged Voided. For an invoice payment the invoice balance is back; for a payment with no invoice, the items it paid for show as unpaid again in Lab, Pharmacy, Imaging and Pending.
Common issues
'This item has already been paid for, so nothing was charged.'
'This item has already been paid for, so nothing was charged.'
'That is more than is still owed on this item, so nothing was charged.'
'That is more than is still owed on this item, so nothing was charged.'
The prefilled amount is not what they paid
The prefilled amount is not what they paid
I recorded a payment against the wrong invoice
I recorded a payment against the wrong invoice
Send payment link is not offered, or is refused
Send payment link is not offered, or is refused
The panel says the email was not sent
The panel says the email was not sent
The patient says the link no longer works
The patient says the link no longer works
They paid online but the invoice still says Pending
They paid online but the invoice still says Pending
Figures on Overview show as dashes
Figures on Overview show as dashes
A lab test or imaging study never showed up under Pending Items
A lab test or imaging study never showed up under Pending Items
A dispensed prescription is not under Pending
A dispensed prescription is not under Pending
FAQ
What is the difference between a direct payment and an invoice payment?
What is the difference between a direct payment and an invoice payment?
Does voiding refund the patient's card?
Does voiding refund the patient's card?
Void Payment says part of the payment was cancelled and credited
Void Payment says part of the payment was cancelled and credited
A refund says it needs approval
A refund says it needs approval
Where do pharmacy counter takings appear?
Where do pharmacy counter takings appear?
Can I print a receipt later?
Can I print a receipt later?