Finance → Collections → Promise to Pay → /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.
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
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.
Set the amount and date
The total the resident has committed to, and when.
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".
Link it to the debt
The promise is linked to the lease and, where relevant, to the invoices it is meant to settle.
Save
The promise becomes active, the ladder pauses where configured, and reminders are scheduled.
Statuses
| Status | Meaning |
|---|---|
| Pending | Made, not yet due. |
| Reminded | A reminder has been sent ahead of the due date. |
| Fulfilled | Paid in full, on or before the date. |
| Partially paid | Some of the committed amount was received. Still live — it can still be settled in full, and it is never marked missed. |
| Missed | The date passed without sufficient payment. |
| Cancelled | Withdrawn before evaluation. |
| Renegotiated | Superseded by a new promise. |
Evaluation is done against actual payments and allocations on the lease — not by anybody ticking a box.
How statuses are grouped
Reporting folds the seven statuses into four groups, and the money each one represents means something different:
| Group | Statuses | The money is |
|---|---|---|
| Live | Pending, Reminded, Partially paid | Still owed |
| Missed | Missed | Still owed |
| Concluded | Fulfilled | Received |
| Closed | Cancelled, Renegotiated | No longer expected |
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 module
Promise to Pay has four pages of its own: Overview (the KPI console), Promises (the list), Call list and Contact log.
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.
Record promise on the list, and Edit on a row, open the same panel in a drawer — so recording a promise and correcting one look and behave identically. The lease, the person promising and the linked invoices are fixed once a promise exists: changing those is a renegotiation, not an edit, so they are shown read-only.
Promise detail
The detail page is laid out as the promise's journey — four steps, showing where this commitment has got to:
Recorded
When it was made, and by whom.
Reminded
How many reminders were sent or are scheduled — or that messaging is off for this promise.
Due
The promised date, and how far away it is.
Outcome
Named for what actually happened: Settled, Part-paid, Missed, Cancelled or Renegotiated — with how late, or how much short.
Underneath: what was promised, what has been received and what is outstanding, with a progress bar. Then tabs for Follow-up (reminder schedule and calls), Payments, History, Comments and Documents.
The page offers one main action at a time — whichever of Log call, Mark fulfilled, Send reminder now, Mark partial payment, Renegotiate, Edit promise or Cancel promise is the sensible next move — with the rest behind the overflow menu. When none apply, the page says why.
Recording money against a promise
Record payment, on the promise's Payments tab or from a row on the list, adds a receipt.
Every increase to the received amount appears in Payments received — whether an officer recorded it or the system detected it. Rows the system matched name the payment behind them and open it, so a figure can always be traced back to the money. This is why the received amount cannot be typed over on the edit form: there would be two ways to change it and only one of them would leave a trail.
A promise that is already settled, missed, cancelled or renegotiated cannot take a further receipt.
How promises interact with collections
| Event | Effect on the case |
|---|---|
| Promise created | Treatment state moves to promise; ladder steps flagged to pause on promise are suspended. |
| Promise kept | Case moves toward clearing as the balance drops; the kept ratio improves. |
| Promise partially kept | Ladder resumes on the shortfall; severity is not escalated as hard as a full miss. |
| Promise missed | Ladder resumes, severity is bumped, and a follow-up task is staged. |
| Promise renegotiated | The new schedule takes over; the case timeline records both. |
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.