Payments & dues
How dues are tracked, payments verified, statements generated, and reminders sent.
The dues model
Each resident has a monthly dues amount. Their statement shows one row per month from their dues-start date (or move-in date) to the current month. Each row tracks:
- The expected dues for that period (plus penalty, if enabled and overdue).
- The amount paid (sum of allocations to that period).
- The remaining balance, with a status: paid / partial / unpaid.
Total balance = sum of unpaid balances across all months. "Months behind" = count of months with a non-zero balance.
How payments are allocated
When a payment is approved, it's auto-allocated to the oldest unpaid period first, then forward. So a resident catching up on 3 months of arrears with one bulk payment clears them oldest-first automatically. You can see exactly which months each payment covered on the resident's profile.
Exception: if a payment is tagged with a Levy (see below), it goes to that levy charge instead of monthly dues.
Resident-submitted payments
Residents go to their /pay page and upload evidence of a payment (bank deposit slip, MoMo screenshot, etc.) along with the amount, date, and reference. The payment appears in your /admin/paymentsqueue with status "pending".
Click any pending payment to:
- View the evidence inline (image preview, PDF viewer).
- Approve — auto-allocates to oldest unpaid months, sends the resident a confirmation email/WhatsApp/SMS with the months it covered and their new balance.
- Reject— prompts you for a reason (e.g. "Wrong amount", "Can't read screenshot"), sends the resident the reason so they can resubmit.
Recording payments manually
For cash drops, walk-in deposits, or any payment that didn't go through the resident's portal: /admin/payments/new. Fill in the resident, amount, date, method, and reference. Optionally attach evidence (photo of a receipt, deposit slip).
Online payments via Paystack
If your HOA has a Paystack account, residents can pay dues online — card, Mobile Money or bank transfer — and money settles directly to your HOA's bank account. Configure at /admin/settings → Online dues payments (Paystack). The resident's /paypage then shows a “Pay online” button alongside the “Upload evidence” option. Successful Paystack payments are auto-approved and auto-allocated. Full walkthrough: Online dues collection with Paystack.
Levies — one-off charges
A levy is a charge outside the regular monthly dues — typical use cases:
- Estate-wide special assessments (security upgrade, road resurfacing).
- Late-joiner contributions for previous infrastructure projects.
- One-off fines.
Create at /admin/levies. Pick whether the levy applies to all active residents or a subset; set the amount per household. Each affected resident gets a levy charge they can see on their statement and pay separately from dues.
Late-payment penalty
Configure at /admin/settings → Late payment penalty. Two options:
- Flat — fixed amount added per month overdue (e.g. GHS 50).
- Percent — percentage of the unpaid dues per month overdue (e.g. 10%).
Grace period (in months) lets you defer the penalty — e.g. 3 months of grace means penalty starts only on the 4th month of an unpaid period. Penalties show up on the statement and are included in the total balance.
For one-off forgiveness (resident going through hardship, special agreement), use the Penalty waiver button on their profile to suppress penalty for a specific month or range. The waiver reason is logged.
Statements
Each resident's statement is automatically generated and visible to them at /dashboard. They see opening balance, every month's dues + penalty + payments + closing balance, and a download link.
On the 1st of every month, HOAPortal automatically emails each resident a summary of the just-ended month. You can also trigger this manually from /admin/payments → Send statements — useful when fixing a wrong email address. Shift-click forces a re-send to everyone (use sparingly).
Automated dues reminders
Configure at /admin/settings → Automated dues reminders. Pick which days of the month to send (e.g. 5th, 15th, 25th) and which channels (email + WhatsApp + SMS, any combination). Residents with a balance above your minimum threshold get a friendly message with their balance.
For an off-schedule push (e.g. "send everyone behind a reminder right now"), use the Send reminders button on /admin/payments. It uses the same channel config and same per-day dedupe — clicking twice in a day won't double-send to anyone.