Payment Flow

Payment begins after the admin assigns a case coordinator. At that point the patient receives a payment link and an in-app prompt to pay. The case cannot proceed to doctor review until payment succeeds.

Flow diagram

flowchart TD
  A[Admin assigns coordinator] --> B[Payment link created and sent to patient]
  B --> C[Patient pays on payment platform]
  C --> D{Payment result}
  D -->|Success| E[Case marked as paid]
  E --> F[Invoice created]
  F --> G[Patient sees confirmation in app]
  G --> H[Coordinator and patient notified]
  D -->|Failed| I[Case marked as payment failed]
  I --> J[Patient can retry or cancel]

What happens on successful payment

Action	Who is affected
Case status updated to payment successful	Patient, coordinator, admin
Invoice created	Finance / billing records
In-app status card updated for patient	Patient
Push notification sent	Coordinator and patient

The coordinator can then assign specialist doctors and begin the clinical review.

What happens on failed payment

• The case is marked payment failed
• The patient may attempt payment again or cancel the case
• No doctor assignment or clinical review begins until payment succeeds

Payment confirmation screen

Before or after paying, the patient can view an order summary (amount, case details) on the payment confirmation screen in the patient app.

---

Technical reference: payment callbacks, endpoints, and database fields are covered in API Flows → App and Database → review_cases.