Skip to main content

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

  1. Open the collections case (or lease detail page)
  2. Click Create arrangement
  3. Set the terms:
    • Total arrears — Amount to be repaid
    • Installment amount — Per-installment payment
    • Frequency — Weekly, biweekly, or monthly
    • Start date and end date — Arrangement period
    • Additional conditions — Optional text for extra terms
  4. The system calculates the installment schedule automatically
  5. Click Create to generate the arrangement

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

StatusDescription
ProposedArrangement created, awaiting tenant acceptance
AcceptedTenant signed the arrangement
ActiveFirst installment date reached, payments being tracked
CompletedAll installments paid successfully
BreachedAn installment was missed — triggers case escalation
CancelledArrangement 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
Public acceptance links

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.