Skip to main content

Adding a Clinic Payment Method: Preserve the Bill and Verify the Collection Route

Adding a payment method during checkout should preserve the patient's bill while an authorised person verifies the new collection route. Separate the software setting from merchant or bank readiness, refresh any changed bill before collecting, and return with a clear outcome. A visible Cash, UPI or Card button is not proof that the clinic can collect or reconcile money through it.

By Bractis · Updated · 8 min read

Indian clinic owners, managers and reception teams adding or changing collection methods while patients are waiting at the desk.

Check permission, configuration and the real payment route

A missing payment option can have several causes: the current user lacks permission, the method is disabled for this location, merchant setup is incomplete, or an otherwise configured service is temporarily unavailable. These conditions need different remedies.

First establish who may change the setting and what its scope is. A manager authorised for one clinic should not accidentally enable a method across unrelated locations or redirect money for another legal entity. Reception needs a route to request the change without borrowing the manager's password.

Then verify the collection arrangement. For UPI, NPCI's merchant FAQ describes working with an acquiring bank and using that bank for transaction-status issues. The application setting does not itself establish the merchant account, correct destination or support arrangement.

Cash needs its own operational setup, such as the responsible drawer or collection point and day-close process. A card terminal needs the relevant merchant and terminal arrangements. Do not treat all methods as identical labels attached to a payment row.

Finally, decide whether the new route is ready for this transaction. A valid merchant configuration can still be temporarily unavailable. Keep that current availability separate from permanent configuration so a short outage does not lead staff to create a second, inconsistent setup.

Source: NPCI: UPI FAQs, merchant onboarding and support

Return to the same bill, then check whether it changed

Before entering settings, retain the patient and encounter identity, bill identifier, service lines, amount already allocated and any unsaved administrative input. The person returning should not have to reconstruct which relative in a shared-phone search was being billed.

Preserving context does not mean assuming the bill remained unchanged. Another authorised user might add a service, correct a charge or record a collection while the settings panel is open. On return, display the current bill and explain relevant changes.

Consider a fictional bill with ₹700 in charges and ₹200 already allocated, leaving ₹500. While the manager verifies a payment route, another authorised user adds an agreed ₹100 service. The current charge is now ₹800 and the remaining balance is ₹600.

If checkout blindly restores the earlier ₹500 collection amount, the payment may be real but leave ₹100 due. The correct response is to show the changed bill and obtain the appropriate agreement before proceeding, not silently increase a request already shown to the patient.

Keep setting changes and bill changes attributable separately. Knowing that UPI was enabled at 11:05 does not explain why a service charge changed at 11:04. Each event needs its own actor, scope and relevant evidence.

If an actual payment request was already submitted before navigation, preserve that reference and outcome. Returning from settings must not automatically submit another request or assume that closing the earlier panel cancelled the provider operation.

A settings screen is not the only place authority matters

OWASP recommends checking authorisation for each request. For a clinic, that means the system should enforce who may change the collection setup when the change is made, rather than rely only on hiding a settings link.

Define the verification appropriate to the method. Check the configured merchant identity, location, receiving arrangement, integration mode and person responsible for reconciliation. Use the provider's current documentation and the clinic's actual agreement.

A synthetic or sandbox exercise can validate the application path without collecting live money. Be explicit about what it proves: a test success can demonstrate routing and handling in that environment, but it does not establish production bank credit or settlement.

In a fictional six-case setup rehearsal, two requests are authorised and ready, two lack verified merchant details, one targets the wrong location and one is attempted by an unauthorised role. Only two should become available for the intended use.

Treat the four blocked cases as useful findings, not failed staff performance. Missing evidence should produce a specific task for the appropriate owner. A generic 'setup incomplete' banner gives reception little help when a patient is waiting.

On a narrow screen, scroll the table horizontally to read all columns.

Payment-method setup: choose the remedy from the actual condition
Observed conditionAppropriate next actionEvidence to retain
Method disabled locallyAuthorised review of why it is disabledSetting scope, decision maker and effective change
Merchant details missingComplete and verify the provider arrangementCorrect entity, location and receiving destination
Wrong location selectedReturn to the intended clinic contextVerified scope before any setting is changed
Staff role cannot configureRequest an authorised person without sharing credentialsRequest and actual actor who performs the change
Provider unavailableUse the agreed outage or alternative routeCurrent availability and any pending transaction reference
Bill changed during setupReview the latest charge and balanceBill version or history and patient-facing explanation

Source: OWASP: Authorization Cheat Sheet

Show what changed and what the desk can do now

After a successful configuration change, give a precise outcome: which method is available, for which location and what verification remains. Avoid a generic success message that staff might interpret as confirmation of the patient's payment.

If the change fails, keep the bill accessible and preserve the original context. Explain whether the setting was not saved, its outcome is uncertain, or the user lacks permission. Those states determine whether to retry, inspect current settings or seek help.

Razorpay's payment API illustrates a separate payment object with statuses such as authorised and captured. This is one provider's model, but it reinforces the distinction between configuring a method and obtaining evidence about a particular payment.

Do not map every provider state to 'paid' merely because the button became available. The clinic needs a defined interpretation of the actual integration, including where confirmation and reconciliation information comes from.

Offer an agreed alternative where appropriate, such as another already verified method or a recorded outstanding balance under clinic policy. The patient should receive an accurate explanation; clinical care and an urgent clinical concern should follow the responsible clinical process.

Source: Razorpay: Fetch a payment by ID

Reconcile configuration changes after the immediate checkout

Review who enabled or disabled a method, which transactions used it and whether money reached the expected receiving arrangement. A configuration change is complete only when the team understands how to operate and reconcile the route.

When replacing a merchant account or terminal, plan what happens to earlier payments, refunds and reports. New transactions may use the new setup while old transaction support still requires access to the previous arrangement.

Keep secret credentials out of screenshots, support chats and routine clinic logs. An operator may need a merchant identifier or case reference without needing the full credential used by the integration.

Train the next shift on the actual change. The person who approved setup may leave before the desk encounters its first unresolved payment. Name the support contact and the evidence staff should collect without asking patients for PINs or other authentication secrets.

Test cancellation as well as success. A manager deciding not to enable the method should return the desk to the original task with the bill intact and the reason understood. Abandoning configuration should not abandon the patient's checkout.

The payment option changed while the bill changed too

The fictional bill starts at ₹700 with ₹200 allocated and ₹500 remaining. An agreed ₹100 service is added during setup, so the current balance is ₹600. Restoring the old ₹500 amount would leave ₹100 due. Context preservation must therefore include a current-state check, not only a return to the same screen.

Rehearse a payment-method change

Use these prompts in your clinic’s own notes. Record the result, responsible person and next action for each item.

Identify the actual blocker
Separate a permission issue, disabled setting, unverified merchant arrangement and temporary outage.
Verify the destination
Confirm the entity, location and receiving arrangement before making the method available.
Test the return
Change a synthetic bill while settings are open and verify the desk sees the current patient, charge and balance.
Plan unfinished work
Define what happens when setup fails, the outcome is uncertain or the patient uses another agreed route.

Questions doctors ask

Does enabling UPI in clinic settings mean the clinic is ready to accept it?

Not by itself. Verify the actual merchant arrangement, destination, location, current availability and reconciliation process as well as the software setting.

Should reception use the owner's login to enable a payment option quickly?

Use an attributable authorised process instead of sharing credentials. The current staff member can request help while retaining the patient's bill and context.

What should happen to an open bill when payment settings are changed?

Its identity and work should be preserved, then current charges and payments checked on return. Another authorised action may have changed the balance while settings were open.

Should a failed payment-method setup clear the checkout?

No. Keep the existing task recoverable and explain what remains unresolved. A setup failure does not justify discarding the patient's bill.

Does a successful sandbox payment prove the production bank route works?

It proves only what was exercised in that test environment. Production merchant details, receiving arrangements and current operational readiness still need appropriate verification.

Sources and scope

Updated on . Original setup and recovery analysis with fictional amounts. Provider references describe their own scope; no live merchant activation, settlement promise or universal payment configuration is asserted. No independent clinical or legal review is claimed.

Try the workflow
with Bractis.

Ask Bractis to demonstrate an authorised method change while a synthetic bill is open, including a concurrent charge change, a denied staff role and cancelled setup. Inspect configuration and payment outcomes separately.

Request a clinic demo