Checkout Page - User Actions Guide
File Path:console/src/app/[tenant]/(console)/billing/check-out/page.tsx
Route: /[tenant]/billing/check-out
Overview
The Checkout page is the primary payment collection interface. It guides staff through creating charges, adding items, and processing payments with support for multiple payment methods including cards, cash, POS terminals, and payment plans.Checkout Flow
Available Actions
1. Select Patient
Purpose: Choose which patient to charge. Step-by-Step Instructions:-
Locate patient selector
- In charge edit step
-
Search for patient
- Type name or phone
- Select from results
-
Or create new patient
- Click “New Patient”
- Enter required info
2. Add Services/Products
Purpose: Add items to the charge. Step-by-Step Instructions:-
Browse available items
- Services list
- Products list
-
Click to add item
- Item added to cart
-
Adjust quantity
- Use +/- buttons
- Or type quantity
-
View running total
- Updates automatically
3. Apply Discount
Purpose: Reduce the charge total. Step-by-Step Instructions:-
Click “Add Discount”
- In cart section
-
Choose discount type:
- Percentage off
- Fixed amount off
-
Enter discount value
- Amount or percentage
-
Apply discount
- Total updates
4. Apply Package Credits
Purpose: Use pre-purchased package services. Step-by-Step Instructions:-
View available packages
- Patient’s packages shown
-
Select package to apply
- Click on package
-
Apply to items
- Matching items reduced
- Package balance decreases
5. Apply Membership Benefits
Purpose: Use membership discounts. Step-by-Step Instructions:-
View membership status
- Active memberships shown
-
Benefits auto-applied
- Member pricing shown
- Discounts calculated
6. Proceed to Payment
Purpose: Move to payment collection. Step-by-Step Instructions:-
Review cart
- Verify items and total
-
Click “Continue to Payment”
- Moves to payment step
7. Pay with Card on File
Purpose: Use saved payment method. Step-by-Step Instructions:-
View saved cards
- Patient’s cards displayed
-
Select card
- Click to choose
-
Process payment
- Click “Pay $X.XX”
- Payment processes
8. Pay with New Card
Purpose: Enter new card details. Step-by-Step Instructions:-
Click “New Card”
- Card form appears
-
Enter card details:
- Card number
- Expiration (MM/YY)
- CVV
- ZIP code
-
Save card (optional)
- Toggle to save for future
-
Process payment
- Click “Pay $X.XX”
9. Pay with POS Terminal
Purpose: Process in-person card payment. Step-by-Step Instructions:-
Select POS Terminal
- Choose terminal device
-
Initiate payment
- Click “Send to Terminal”
-
Wait for customer action
- Page shows processing
- Customer interacts with terminal
-
Complete transaction
- Insert/tap/swipe card
- Enter PIN if required
- Approve amount
-
View result
- Success or failure shown
10. Pay with Cash
Purpose: Record cash payment. Step-by-Step Instructions:- Select “Cash” payment
-
Enter amount tendered
- What customer gave
-
View change due
- Calculated automatically
-
Complete payment
- Record transaction
11. Add Tip
Purpose: Include gratuity. Step-by-Step Instructions:-
Locate tip section
- In payment step
-
Enter tip amount
- Fixed amount or percentage
- Select preset or custom
-
Apply tip
- Added to total
12. Set Up Payment Plan
Purpose: Split payment into installments. Step-by-Step Instructions:-
Click “Payment Plan”
- Plan options appear
-
Configure plan:
- Down payment amount
- Number of installments
- Payment frequency
-
Enter card for autopay
- Card used for scheduled payments
-
Confirm plan
- Plan created
- First payment processed
13. Preview Charge
Purpose: See charge details before finalizing. Step-by-Step Instructions:-
Click “Preview” button
- In header
-
Review all details:
- Items and prices
- Discounts applied
- Final total
-
Close preview
- Return to editing
14. Cancel Checkout
Purpose: Abandon the checkout process. Step-by-Step Instructions:-
Click back/cancel
- In header
-
Confirm cancellation
- Warning may appear
- Unsaved changes lost
15. Print Receipt
Purpose: Generate receipt after payment. Step-by-Step Instructions:-
Complete payment
- Success screen shown
-
Click “Print Receipt”
- Opens print dialog
-
Print or save PDF
- Choose printer
- Or save as PDF
16. Send Receipt
Purpose: Email/text receipt to patient. Step-by-Step Instructions:- On success screen
-
Click “Send Receipt”
- Options appear
-
Choose method:
- Email receipt
- Text receipt link
-
Confirm send
- Receipt delivered
URL Parameters
Checkout can be pre-populated:?patientId=xxx- Pre-select patient?chargeId=xxx- Load existing charge?eventId=xxx- Link to appointment
Permissions
| Action | Admin | Manager | Staff |
|---|---|---|---|
| Create charges | ✓ | ✓ | ✓ |
| Process payments | ✓ | ✓ | ✓ |
| Apply discounts | ✓ | ✓ | Limited |
| Create payment plans | ✓ | ✓ | ✗ |
| Use POS terminal | ✓ | ✓ | ✓ |
Troubleshooting
| Issue | Solution |
|---|---|
| Card declined | Try different card, check details |
| POS not connecting | Check terminal status, restart |
| Can’t apply package | Verify package has remaining balance |
| Discount not applying | Check discount rules |
| Payment stuck processing | Wait, then refresh if needed |
