/payment-promises Beta
A Promise to Pay is a recorded commitment from a resident: an amount, by a date, optionally
split into instalments. Recording it is what turns “he said he’d pay on Friday” from a note in
somebody’s head into something the system tracks, evaluates and reports on.
This surface was previously labelled Payment Promises. It is the same module — the name changed
to match how officers talk about it.
Why it matters
A recorded promise does three things a note cannot:- Pauses the dunning ladder on steps configured to pause on an active promise, so a tenant who is cooperating does not get a demand letter three days later.
- Is evaluated automatically against actual payments — kept, partially kept, or missed — with no manual reconciliation.
- Feeds the collectability score. Promise-kept ratio and how recently a promise was broken are both scoring features, so a tenant’s track record follows them.
Recording a promise
1
Start from the case or the module
From a collection case, logging an interaction with
the outcome promises deep-links straight into creating one. You can also go to
Promise to Pay → Create.
2
Set the amount and date
The total the resident has committed to, and when.
3
Add instalments if it is an arrangement
Split the total across dated instalments. Each instalment is evaluated on its own, so a tenant
paying two of three is partially fulfilled, not simply “missed”.
4
Link it to the debt
The promise is linked to the lease and, where relevant, to the invoices it is meant to settle.
5
Save
The promise becomes active, the ladder pauses where configured, and reminders are scheduled.
Statuses
Evaluation is done against actual payments and allocations on the lease — not by anybody ticking a
box.
Renegotiation
When a resident cannot meet a promise and agrees a new arrangement, renegotiate rather than edit. Renegotiation:- marks the old promise terminal and links the new one to it, preserving the chain;
- cancels only the pending instalments of the old schedule;
- never overwrites history — you can always see how many times an arrangement has been reset.
The list
The list shows every promise with its status chips, amount, promised date, received amount, lease, resident and linked case. Filter by status to build the two queues that matter operationally:- Due today — promises falling due now, ready for a pre-emptive reminder.
- Missed — promises that failed, which should resume the ladder and raise case severity.
Promise detail
The detail page shows the commitment, the instalment schedule with each instalment’s own state, the received amount to date, the linked lease and invoices, the renegotiation chain, and the timeline of reminders sent.How promises interact with collections
Good practice
- Record the promise during the call, not after. An unrecorded promise is invisible to the engine, and the tenant will get the next ladder step.
- Split anything above one month’s rent into instalments — a single large promise is far more likely to be missed outright, and a miss is harsher on the score than a partial.
- Set the promised date to a date the tenant chose. Promises with dates imposed by the officer have a materially worse kept rate.
- Check the Missed queue daily; a missed promise is the strongest single signal that a case needs escalation.