Payment arrangements
Payment arrangements let you offer tenants a structured plan to repay arrears over time. Arrangements include formal terms, a tenant acceptance flow, and breach detection.
Creating an arrangement
There's currently no button or form anywhere in the app to create a payment arrangement — the case detail page, lease detail page, and collections list don't have a "Create arrangement" action. Arrangement terms (total arrears, installment amount, frequency, dates, conditions), the installment schedule, and breach detection are all implemented on the backend, and the tenant-facing acceptance link works once an arrangement exists — but there's no UI path for a landlord to create one today.
Sending to the tenant
Each arrangement generates a secure public link that does not require the tenant to log in. You can send this link via email or SMS.
The tenant views:
- Full arrangement terms
- Installment schedule with amounts and dates
- Acknowledgment checkbox
- Signature canvas (draw or type)
Once the tenant signs and submits, the arrangement status moves from proposed to accepted.
Arrangement lifecycle
| Status | Description |
|---|---|
| Proposed | Arrangement created, awaiting tenant acceptance |
| Accepted | Tenant signed the arrangement |
| Active | First installment date reached, payments being tracked |
| Completed | All installments paid successfully |
| Breached | An installment was missed — triggers case escalation |
| Cancelled | Arrangement cancelled by either party |
PDF generation
A formal PDF of the arrangement is generated automatically, including:
- Terms and installment schedule
- Tenant signature
- Signing timestamp and metadata
The PDF is stored on the case for evidence purposes.
Breach detection
The collections orchestrator monitors installment dates. If a scheduled payment is not made by the due date:
- The arrangement status changes to breached
- The breach date and reason are recorded
- The associated collections case is escalated
The acceptance link includes a secure token with an expiration date. Once expired, the tenant can no longer accept — you would need to create a new arrangement.