UPI Payment Pending at a Clinic: A Reception and Reconciliation Workflow
Handle pending UPI payments with merchant verification, a named follow-up owner, safe fallback payment and duplicate-credit reconciliation.
Prevent duplicate clinic receipts by treating each intended collection as one durable operation, even when the browser retries it. A disabled button alone is insufficient. The server needs a way to recognise the same request, validate its unchanged amount and bill, and return or recover the existing result. An unknown response must not automatically become a second collection.
Clinic owners evaluating billing reliability, reception supervisors handling slow connections and developers responsible for payment-to-receipt integration.
A receptionist clicks “Record payment”, the spinner stops responding and the patient is still standing at the counter. The browser may have lost the response after the server saved the receipt. Clicking again can then create two records for one cash collection. Alternatively, an online checkout may actually collect money twice. Those failures need different remedies.
Use three separate concepts: the clinic’s intended collection, the external payment transaction where one exists, and the receipt that acknowledges the recorded collection. A receipt reprint should refer to the same receipt. A second legitimate instalment should create a new collection. A second bank debit should be investigated as additional money, not concealed by deleting a receipt.
The practical question is not whether the button looks responsive. It is whether the system can explain what happened after a timeout, browser refresh, staff handover or delayed provider notification. That evidence is what allows reception to act without asking the patient to pay again unnecessarily.
An idempotency key is an identifier used to recognise retries of one intended operation. The application needs to preserve it when the same operation is retried and create a different one for a genuinely new operation. It should be an opaque identifier, not a patient name or phone number.
Stripe’s API documentation illustrates one implementation: API v1 compares request parameters and returns the saved result for a recognised key after execution begins. Its documented retention and error semantics are provider-specific. A clinic vendor cannot assume that putting an arbitrary header on another provider’s endpoint gives the same protection.
For an internal receipt, the protected request should bind the clinic, bill or allocation, amount, currency, payment method and relevant transaction reference. Reusing the same key with ₹600 after originally requesting ₹500 should produce a conflict or a controlled recovery path, not quietly modify the old receipt. A correction should be an explicit new action.
The protection must survive two requests arriving together. A read-before-write check without an atomic uniqueness or transaction boundary can still create two receipts. Ask for evidence of the server-side design and a concurrent-request demonstration; a front-end debounce proves only that one screen limits rapid clicking.
The screen should distinguish a request that was never sent from one whose result is unknown. Both may look like a network error, but only the first is clearly safe to start as a new operation. Recovery should first look up the existing operation and provider transaction, using the references already created.
Provider notifications can arrive later than the browser response. Razorpay documents duplicate webhook delivery and events arriving out of order. Therefore the application also needs event-level deduplication and a rule preventing an older notification from overwriting a newer known payment state.
Neither deduplication layer replaces reconciliation. Two distinct provider transaction IDs may represent two real successful collections for the same bill. Both must remain visible until the surplus is resolved. Suppressing the second event because the bill is already paid can hide money owed back to the patient.
On a narrow screen, scroll the table horizontally to read all columns.
| Observed state | First question | Expected response |
|---|---|---|
| No request sent | Was an operation created locally? | Resume the intended operation safely |
| Response lost | Did the server save it? | Recover the existing result |
| Same request twice | Do key and payload match? | One collection, one receipt |
| Changed amount | Is this still the same intent? | Reject mismatch; use an explicit new action |
| Webhook repeated | Was this event already processed? | No additional ledger effect |
| Two real payments | Are both provider IDs successful? | Record both; resolve the surplus |
In a fictional case, a patient hands over ₹800 in cash. Reception records it with operation C-104. The server creates receipt R-510, but the response is lost. Retrying C-104 with the same details should recover R-510. The ledger and drawer both show ₹800, and printing again creates another copy of R-510 rather than R-511.
If the second click creates a fresh operation and receipt, the ledger shows ₹1,600 while the drawer contains ₹800. The resulting ₹800 apparent shortage is a duplicate-record problem, not evidence that cash disappeared. Correct it through a linked reversal or approved correction while retaining the original event history.
Contrast that with an online bill for ₹800 where two different successful payments of ₹800 arrive. The clinic has collected ₹1,600 against an ₹800 charge. The ₹800 surplus needs an authorised refund or other explicit resolution. Deduplicating on the amount, patient or bill alone would discard evidence of the extra collection.
A procedure paid in two valid ₹800 instalments is a third case. Equal amounts do not establish duplication. The allocation plan, separate collection intentions and transaction references establish why both are valid.
An uncertain-result message should show an operation reference, the last known state and a clear lookup action. It should not tell staff both “payment failed” and “do not retry” without explaining which fact is known. Staff need to know whether they are recovering a record, checking a provider transaction or starting a new collection.
If the connection remains unavailable, use the clinic’s controlled downtime record. Capture only the references and amounts needed for later matching, mark the status honestly and assign one owner to complete the check. Do not issue a normal paid receipt for an unverified online payment merely to clear the queue.
Where another payment method is agreed as a fallback, link it to the unresolved attempt. That creates an explicit duplicate-credit watch if the first attempt later succeeds. A handover note must preserve this relationship rather than giving the evening receptionist an unexplained unpaid bill.
Use fictional data and a sandbox provider. Interrupt the browser after a collection request reaches the server, then restore the connection and retry. Refresh the page and repeat from another authorised desk. Verify the number of collection records, receipt numbers and payment references, not just the final green banner.
Change the amount while reusing the original operation reference. Replay a provider notification and deliver an earlier event after a later one. Then create two deliberate instalments of the same amount. A credible test must prevent accidental repetition while still allowing legitimate payments.
Ask what happens when the provider’s idempotency retention expires, when recovery crosses a day boundary and when the server restarts. The vendor should explain which records remain durable and which unresolved cases require reconciliation. No idempotency mechanism promises that external banks, the application and receipt printing always finish simultaneously.
Keep the acceptance criterion observable: one intended collection has one financial effect, every actual external payment remains traceable, and unresolved states remain visible until an authorised person resolves them. This is more useful than an unqualified claim that double billing is impossible.
At 11:05, reception A records ₹600 and loses the response. Reception B opens the same pending operation at 11:06 and retrieves the already-issued receipt. Both printouts carry the same receipt number and the ledger contains one ₹600 collection. A later ₹200 balance payment receives a new operation and receipt. Recovery has prevented duplication without preventing a valid second instalment.
Use these prompts in your clinic’s own notes. Record the result, responsible person and next action for each item.
A retry of the same intended operation should use the recovery mechanism and key defined for that operation. A new key can create a new effect. Provider rules vary, so confirm the endpoint’s actual semantics and handle uncertain results before starting again.
Give each genuine collection its own intention and reference, then allocate it to the appropriate balance. Do not treat equal patient, amount and date fields as sufficient proof of duplication. Two instalments can be valid even when all three match.
Retain both verified payments and calculate the surplus against the valid charge. Resolve the excess through an authorised process. Event deduplication must not hide a second real payment simply because the bill was already marked paid.
No. It provides a concrete evaluation method. Ask for the current implementation, supported provider behaviour and a sandbox demonstration of timeout recovery, concurrent retries and legitimate instalments before making a purchasing decision.
Updated on . Technical evaluation guidance, checked 25 October 2026. API examples are provider-specific and do not establish current Bractis support or a guarantee against every payment failure. No independent clinical or legal review is claimed.
A technical example of retry semantics and parameter checks, not a recommendation of provider availability for Indian clinics.
Provider documentation on signature validation, duplicate event IDs and unordered delivery. Applies to that integration, not every payment system.
Handle pending UPI payments with merchant verification, a named follow-up owner, safe fallback payment and duplicate-credit reconciliation.
Reconcile clinic gateway collections through payment IDs, webhook checks, settlement deductions and bank matches without changing patient dues.
Record procedure advances, allocate instalments and handle revised treatment costs with worked balances, refunds and a patient statement.
Demonstrate an interrupted ₹800 collection, recover the same receipt, then record a legitimate second instalment. Use only fictional data and sandbox transactions.
Request a clinic demo