Help center

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.

Need a hand? Email us — or check the FAQ for quick answers.