Skip to content

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:

  1. approved deferredUntil, when present and deferralPending is not true;
  2. otherwise tenantWindowTo;
  3. 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ść czynszowa in 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_DUE and PAYMENT_OVERDUE notification 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.