Skip to main content

Scan to Pay

The Scan to Pay flow enables patients to complete payment for walk-in visits using a QR code generated at the clinic.


Walk-in Scan to Pay QR screen

This screen includes:

  • Location selector (when multiple locations exist)
  • Doctor selector (when required)
  • QR code display
  • Instruction message

Workflow​

This flow involves two participants:

  • Clinic (QR generation)
  • Patient (payment completion)

Clinic Flow​

  1. Select visit configuration.
  2. Generate QR code.
  3. Display QR code to patient.

Patient Flow​

After scanning the QR code:

  1. Open Scan to Pay flow.
  2. Authenticate or register.
  3. Review charges.
  4. Confirm payment.

Payment Behavior​

  • Load charges based on QR session data.
  • Apply pricing rules from booking flow.
  • Process payment through standard payment methods.

Validations​

These rules enforce eligibility and flow correctness.

ScenarioApp behaviorSDK output
Visit supports Scan to Pay.Display QR code.QR payload generated.
Visit does not support Scan to Pay.Disable QR and display fallback message.QR generation blocked.
Multiple locations exist.Require selection before QR generation.Selection state required.
Multiple doctors exist.Require selection before QR generation.Selection state required.
QR scanned with invalid payload.Block flow.Invalid session response.
Patient not authenticated.Require login.Auth required state.
Payment fails.Block completion.Payment failure response.
Payment succeeds.Complete flow.Payment success event.

Actions​

ScenarioApp behaviorSDK output
QR generated.Display QR code.QR session created.
QR scanned.Open patient flow.Session transferred to patient app.
Payment initiated.Start payment process.Payment session created.
Payment completed.Finalize visit.Payment success event.
QR unavailable.Display fallback instruction.No QR session created.

Endpoint Resources​

🧰 Endpoint Resources under construction