Payment Plans
Help clients manage larger bills with structured payment plans. Praxi automates payment collection and tracking.
Overview
Payment plans allow clients to pay invoices over time:
| Feature | Description |
|---|---|
| Flexible scheduling | Weekly, fortnightly, monthly |
| Automatic collection | Scheduled card charges |
| Progress tracking | Visual payment progress |
| Reminders | Automated before each payment |
| Failed payment handling | Retry logic and notifications |
| ACID compliance | Financial transactions use pg-boss for exactly-once processing |
Payment plan charges are processed through Praxi's pg-boss queue, which provides PostgreSQL-backed transaction guarantees. Each scheduled payment is processed exactly once — no duplicate charges, no missed payments — even in the event of system interruptions. :::
Creating Payment Plans
From Billing Dashboard
- Go to Billing → Payment Plans
- Click Create Plan
- Select client
- Select invoices to include
- Configure schedule
- Create plan
Plan Configuration
| Setting | Options | Notes |
|---|---|---|
| Frequency | Weekly, Fortnightly, Monthly | Most common is fortnightly |
| Number of payments | 2–104 | Up to two years |
| Start date | Any future date | Allow time for card setup |
| Minimum payment | Practice setting | e.g., $25 minimum |
Payment Collection
Automatic Payments
With Stripe integration:
- Client's card saved securely
- Payments charged automatically on schedule
- Receipt sent after each payment
- Invoice updated with payment
Manual Payments
For cash or bank transfer:
- Open payment plan
- Click Record Payment
- Enter amount and method
- Payment applied to plan
Managing Plans
Viewing Plans
Billing → Payment Plans
Filter by:
- Status (active, paused, completed, cancelled, defaulted)
- Client
- Start date
- Amount range
Plan Statuses
| Status | Meaning |
|---|---|
| Active | Payments being collected |
| Paused | Temporarily stopped (client request or failed payment) |
| Completed | All payments made |
| Cancelled | Plan terminated early |
| Defaulted | Repeated payment failures; manual intervention needed |
Processing Instalments Manually
You can manually trigger the next instalment on a payment plan:
- Open the plan
- Click Process Instalment
- The next scheduled payment is charged immediately
- The plan schedule updates accordingly
This is useful when a client wants to make a payment early or when catching up after a resumed plan.
Pausing Plans
Temporarily stop payments:
- Open the plan
- Click Pause Plan
- Set resume date (optional)
- Confirm
Paused plans:
- Stop automatic payments
- Resume manually or on set date
- Maintain payment history
Cancelling Plans
To end a plan early:
- Open the plan
- Click Cancel Plan
- Choose handling:
- Convert remaining to single invoice
- Write off remaining
- Mark as settled
- Enter reason
- Confirm
Failed Payments
Automatic Retry
When a payment fails, Praxi uses an intelligent retry schedule:
| Attempt | Timing | Action |
|---|---|---|
| 1st failure | Immediate | Notification sent to client |
| 2nd attempt | ~1 hour later | Retry with same card |
| 3rd attempt | ~1 hour later | Retry with same card |
| 4th attempt | ~1 hour later | Final retry |
| After 4 failures | Immediate | Plan defaulted, manual intervention required |
Common Failure Reasons
| Reason | Description | Resolution |
|---|---|---|
| Insufficient funds | Card declined | Client adds funds or changes card |
| Card expired | Card past expiry date | Update card details |
| Card cancelled | Card no longer active | Add new card |
| Bank block | Issuer blocked transaction | Client contacts bank |
| Invalid card | Card details incorrect | Re-enter card details |
| Fraud protection | Bank flagged as suspicious | Client authorises with bank |
Failed Payment Notifications
Client receives:
- Immediate SMS and email notification of failure
- Direct link to update payment details
- Clear explanation of what happened
- Reminder 24 hours before retry attempt
Practice receives:
- Dashboard alert for failed payment
- Daily failed payment summary email
- Client contact information for follow-up
- Plan status automatically updated
Resolving Failures
- Contact client within 24 hours (phone or SMS)
- Identify the issue (insufficient funds, expired card, etc.)
- Update payment method through client portal or reception
- Retry payment manually to verify new details work
- Resume plan - payments continue on schedule
Configure your payment gateway to send pre-payment notifications 3 days before each scheduled payment. This gives clients time to ensure funds are available.
Client Experience
Client Portal View
Clients can see:
- Payment plan summary
- Payment schedule
- Payment history
- Next payment date and amount
Client Actions
Clients can:
- View plan details
- Update payment method
- Make early payments
- Request plan changes
Notifications
| Event | Notification |
|---|---|
| Plan created | Welcome email with schedule |
| Payment due | 3 days before reminder |
| Payment collected | Receipt |
| Payment failed | Update card request |
| Plan completed | Thank you message |
Integration with Accounting
Xero/MYOB Treatment
Payment plans sync as:
- Original invoice (full amount) posted on creation date
- Partial payments recorded as received on payment date
- Balance tracked in accounts receivable until completion
- Revenue recognised on invoice date (accrual accounting)
Revenue Recognition
For Australian accounting standards (AASB 15):
| Approach | When to Use | Praxi Setting |
|---|---|---|
| On invoice | Most healthcare practices | Default |
| On payment | Cash-basis accounting | Contact Praxi support |
| On service | Prepaid packages | Automatic for packages |
Reconciliation
Match bank deposits to plan payments:
- Import bank statement (or connect live feed)
- System auto-matches plan payments by:
- Amount
- Reference number
- Date proximity
- Review and confirm matches
- Clear exceptions manually
- Plan status updates automatically
Stripe/Tyro Integration
For integrated payment gateways:
- Payments reconcile automatically
- Bank deposits match gateway settlements
- No manual matching required for card payments
- Cash and bank transfers still need manual reconciliation
Best Practices
Setting Up Plans
- Verify contact details - Ensure we can reach client
- Save payment method - Card on file before starting
- Confirm understanding - Client agrees to terms
- Document agreement - Keep written confirmation
Managing Problem Plans
| Issue | Resolution |
|---|---|
| Repeated failures | Contact for new card, consider direct debit |
| Client unresponsive | Send reminder, consider pause |
| Financial hardship | Offer extended plan, reduced payments |
| Dispute | Review and resolve, adjust if needed |
Tips
- Start plans promptly - Set up before debt grows
- Keep payment amounts manageable - Affordable = successful
- Send reminders - Pre-payment reminders reduce failures
- Monitor actively - Don't let failed plans age
- Be flexible - Adjust plans when needed