Rent Reminder Rules¶
Prepared: 2026-06-25
These rules define the paid-pilot rent reminder behavior for off-ledger rent tracking. They are product and implementation guidance, not legal advice.
Scope¶
Rent reminders are operational prompts tied to payment requests. They help a tenant see what is due and help an owner see what needs follow-up.
Rent reminders are not:
- statutory arrears warnings;
- termination notices;
- rent increase notices;
- eviction, enforcement, debt collection, penalty, or interest workflows;
- proof that a legal notice was delivered.
Any future statutory notice flow must be separate, counsel-reviewed, and must model delivery evidence, signature/form requirements, and lease-type rules.
Due Date Source¶
For each payment request, the effective reminder date is:
- approved
deferredUntil, when present anddeferralPendingis not true; - otherwise
tenantWindowTo; - no automated reminder when neither date exists.
While deferralPending=true, tenant due/overdue reminders are paused for that
payment request. The owner already receives the deferral-review notification.
If the owner approves the deferral, reminder timing restarts from the approved
deferredUntil date. If the owner rejects it, timing returns to
tenantWindowTo.
Timing¶
Use Europe/Warsaw at 09:00 local time until property-level time zones exist. Run the reminder scan at least hourly and send only when the rule key has not already been sent for that payment request.
| Rule key | Send when | Recipient | Condition |
|---|---|---|---|
rent_due_before_N |
effective due date minus configured reminder days | Tenant | request is PENDING or PARTIALLY_PAID |
rent_due_today |
effective due date | Tenant | request is PENDING or PARTIALLY_PAID |
rent_overdue_1 |
1 day after effective due date | Tenant and owner | request is PENDING or PARTIALLY_PAID |
rent_overdue_7 |
7 days after effective due date | Tenant and owner | request is still PENDING or PARTIALLY_PAID |
The configured before-due value comes from reminderDaysBeforeEnd on the
payment schedule. The launch default is 3 days. The UI may continue offering
1, 3, 7, and 10 days, while the backend accepts the existing 0..60
range.
After rent_overdue_7, do not send more tenant reminders automatically during
the pilot. The owner dashboard and lease payment list keep the request visible
as overdue.
Channels¶
Launch channels:
- in-app notification;
- push notification when the user has an active device token.
Email channel:
- enabled only after Epic 6 email delivery is verified;
- uses the same rule keys and copy;
- must include an unsubscribe or notification-settings path when productized.
Do not send SMS in the paid pilot.
Copy Contract¶
All reminder copy must be neutral and operational. It should name the payment, amount, due date, and action. It must not threaten legal consequences or imply a formal notice.
English¶
| Rule key | Title | Body |
|---|---|---|
rent_due_before_N |
Rent payment coming up | {{amount}} {{currency}} for {{propertyName}} is due on {{dueDate}}. Open the payment request to check transfer details or upload proof. |
rent_due_today |
Rent payment due today | {{amount}} {{currency}} for {{propertyName}} is due today. Open the payment request to check transfer details or upload proof. |
rent_overdue_1 |
Rent payment needs attention | {{amount}} {{currency}} for {{propertyName}} is 1 day past the due date. Open the payment request to check details or upload proof. |
rent_overdue_7 |
Rent payment still needs attention | {{amount}} {{currency}} for {{propertyName}} is still open. Open the payment request to check details or update the record. |
Polish¶
| Rule key | Title | Body |
|---|---|---|
rent_due_before_N |
Zbliża się termin czynszu | {{amount}} {{currency}} za {{propertyName}} ma termin {{dueDate}}. Otwórz płatność, aby sprawdzić dane przelewu albo dodać potwierdzenie. |
rent_due_today |
Czynsz do opłacenia dzisiaj | {{amount}} {{currency}} za {{propertyName}} ma termin dzisiaj. Otwórz płatność, aby sprawdzić dane przelewu albo dodać potwierdzenie. |
rent_overdue_1 |
Płatność wymaga uwagi | {{amount}} {{currency}} za {{propertyName}} jest 1 dzień po terminie. Otwórz płatność, aby sprawdzić szczegóły albo dodać potwierdzenie. |
rent_overdue_7 |
Płatność nadal wymaga uwagi | {{amount}} {{currency}} za {{propertyName}} nadal jest otwarta. Otwórz płatność, aby sprawdzić szczegóły albo zaktualizować status. |
Banned Reminder Wording¶
Do not use these terms or close variants in rent reminders:
- English:
arrears warning,formal notice,termination,eviction,debt collection,penalty,interest,legal action,final demand; - Polish:
wezwanie do zapłaty,zaległość czynszowain notification copy,wypowiedzenie,eksmisja,windykacja,kara,odsetki,ostateczne wezwanie,działania prawne.
Dashboard labels may continue using concise status words such as overdue,
po terminie, or wymaga uwagi.
Payload Contract¶
Reminder notifications should carry enough context for mobile clients to route directly to the payment request:
type: one of the rule keys above;leaseId;requestId;propertyId;propertyName;amount;currency;effectiveDueDate;daysOffset;periodMonth;periodYear.
Use one deduplication key per requestId and rule key. A payment request that
becomes PAID or CANCELED must not receive further reminders.
Implementation Notes¶
- Existing
PAYMENT_DUEandPAYMENT_OVERDUEnotification templates can carry these reminders. - Reminder creation should be idempotent and safe to retry from scheduled jobs.
- Owner-facing overdue reminders should be action prompts, not tenant-facing legal messages.
- Every sent reminder should be auditable through notification history.