Skip to main content

Cancel Request

Use the Cancel Appointment screen to stop a scheduled visit or end a pending request. The app opens this screen when the patient selects Cancel request or when a request expires after inactivity.


This screen includes

  • Automatic expiry after inactivity.
  • Cancel dialog that asks for a reason.
  • Optional text box when the patient selects Other (please specify).
  • Late-window notice that states a charge applies when the cancellation window has passed (for example, less than 3 hours before the visit).
  • Confirmation banner after a successful cancellation.
  • Read-only state after cancellation with actions disabled.

Workflow​

Manual cancellation​

  1. Open Appointment details.
  2. Select Cancel request for a pending request (or Cancel appointment for a confirmed visit).
  3. If the start time is inside the cancellation window, the app shows a notice that a charge applies.
    Options: Keep visit or Cancel appointment.
  4. The app asks: Why do you want to cancel the request?
    Default reasons:
    • I feel better.
    • I found a closer location.
    • I found an earlier appointment.
    • It took too long for the doctor to answer.
    • Other (please specify).
  5. If the patient selects Other (please specify), enter a short explanation.
  6. Select Cancel request to confirm.
    The app shows a confirmation banner in red and disables actions for the canceled item.

Automatic expiry​

  1. The app sends a request and waits for the doctor’s response.
  2. If the doctor does not respond within the time limit, the request expires automatically.
  3. The app returns control to Appointment details with actions disabled for the expired item.

Validations​

  • Require a cancellation reason, with Other (please specify) allowing free-text input.
  • Show the text box only when Other (please specify) is selected.
  • Detect the late cancellation window and show the charge notice before final confirmation.
  • Confirm the action before canceling the appointment or request.
  • Disable actions after cancellation or expiry.

Actions​

  • Open the Cancel request flow from Appointment details.
  • Present the reason list and capture the selected value or free-text note.
  • Apply the late-window rule and block or warn as configured.
  • Cancel the appointment or expire the request and set the item to a read-only state.
  • Show a confirmation banner and return to Appointment details.

Endpoint Resources​

🧰 Endpoint Resources under construction