Payment Methods
Use the Payment Methods screen to select and authorize a payment option for an appointment request.
This screen supports saved cards and digital wallets and adapts available options based on platform and device capabilities.
This screen includes:
- A payment method selector that lists supported options for the current platform.
- An Apple Pay option that appears when the device supports Apple Pay and a wallet exists.
- A Google Pay option that appears when the browser or device supports Google Pay.
- A saved card option that displays masked card details when a card exists on file.
- An add new card option that opens secure card input fields.
- Card input fields that validate card number, expiration date, and CVC.
- A save card toggle that encrypts and stores card details for reuse.
- A secure payment indicator that confirms encryption and supported card networks.
Wallet options appear only when the device, browser, and user account support them.
Workflow
The app handles all payment data through PCI-compliant providers.
Air Doctor does not store raw card details.
This sequence describes how a patient selects and confirms a payment method.
- Review appointment details on the Request Summary screen.
- View the Payment Methods section when payment applies.
- Select one available option in priority order:
- Apple Pay, when supported.
- Google Pay, when supported.
- Saved card on file.
- Add new card.
- Enter required payment details when applicable.
- Confirm the request using the appropriate action:
- Confirm Request for card-based payments.
- Wallet confirmation for Apple Pay or Google Pay.
Payment authorization occurs only after the patient confirms the request.
Validations
These rules enforce secure authorization and input accuracy.
| Scenario | App behavior |
|---|---|
| No payment method selected. | Blocks submission and highlights the selector. |
| New card details are incomplete or invalid. | Displays inline validation errors for affected fields. |
| Wallet option is unavailable on the device. | Hides or disables the option. |
| Saved card authorization fails. | Displays an error and requests an alternate method. |
| Payment authorization fails or is declined. | Prevents request submission and displays a failure message. |
All validations complete before payment authorization.
Actions
Payment handling follows provider and platform rules.
| Scenario | App behavior |
|---|---|
| Patient selects a payment method. | Initializes a secure Stripe or wallet session. |
| Authorization succeeds. | Generates a payment token and attaches it to the appointment request. |
| Saved card selected. | Retrieves a secure reusable token. |
| Authorization fails. | Displays an inline error and allows method change. |
| Payment flow canceled. | Retains entered data until session expiration. |
Platform Availability
| Platform | Apple Pay | Google Pay | Saved card | Add new card |
|---|---|---|---|---|
| Web (Chrome) | No | Yes | Yes | Yes |
| Web (Safari) | Yes | No | Yes | Yes |
| Mobile Web (Chrome) | Yes (iOS 16+) | Yes | Yes | Yes |
| Android Native | No | Yes | Yes | Yes |
| iOS Native | Yes | No | Yes | Yes |
Endpoint Resources
🧰 Endpoint Resources under construction