Skip to main content

​
Overview

The Payments module provides comprehensive financial management for community operations. Track resident charges (cargos), record payments, monitor outstanding balances, and generate reports for accounting and transparency.

​
Key Features

Charge Management

Create and track charges for maintenance fees, assessments, and services

Payment Recording

Record payments from residents with proof of payment uploads

Balance Tracking

Monitor resident account balances and outstanding amounts

Financial Reports

Generate reports on payments, delinquencies, and community finances

​
Understanding the Payment System

​
Two-Component Structure

Happy Habitat uses a dual-tracking system:
  1. Charges (Cargos): Amounts owed by residents
  2. Payments: Amounts paid by residents
A resident’s balance = Total Charges - Total Payments

​
Charge Management (Cargos)

​
Creating Resident Charges

1

Access Charges Section

Navigate to “Charges” or “Cargos” and select the community from the filter dropdown.
2

Select Resident

Choose which resident to charge:
  • Use the resident filter dropdown
  • Search by name or unit number
3

Enter Charge Details

Complete the charge form:Basic Information
  • Resident: The resident being charged
  • Date: Charge effective date
  • Description: Clear explanation of the charge
    • Example: “Monthly Maintenance Fee - January 2024”
    • Example: “Special Assessment - Roof Repair”
    • Example: “Late Fee - December 2023”
  • Amount: Charge amount in currency
Status
  • Active: Outstanding charge not yet paid
  • Paid: Fully paid
  • Partially Paid: Some payment received
  • Cancelled: Voided or reversed charge
4

Save Charge

Click “Save” to create the charge. The system records:
  • Creation timestamp
  • Who created the charge
  • Resident’s account is updated
Charges don’t automatically deduct when payments are made. Update the charge status manually or use batch processing to match payments to charges.

​
Charge Types

Common charge categories:
Regular recurring charges for community operations:
  • Common area maintenance
  • Landscaping and groundskeeping
  • Insurance and utilities
  • Administrative costs
  • Reserve fund contributions
Best Practice: Create these charges at the beginning of each month for all residents.
One-time charges for major projects:
  • Building repairs (roof, foundation, painting)
  • Capital improvements
  • Emergency repairs
  • Legal fees for disputes
Best Practice: Communicate special assessments in advance and provide detailed descriptions.
Charges for amenity usage:
  • Clubhouse rental
  • Guest parking permits
  • Pool guest fees
  • Event space usage
Best Practice: Link to the amenity reservation system for automatic charge creation.
Penalties for late payments:
  • Percentage-based late fees (e.g., 5% of balance)
  • Flat late fees (e.g., $25)
  • Interest on overdue amounts
Best Practice: Ensure late fee policies are documented and consistently applied.
Fees for specific services:
  • Key replacement
  • Access card fees
  • Document copies
  • Violation fines
Best Practice: Clearly describe the service provided.

​
Viewing and Managing Charges

The charges list displays:
  • Resident Name: Who owes the charge
  • Unit Number: Resident’s address
  • Date: Charge date
  • Description: What the charge is for
  • Amount: How much is owed
  • Status: Current payment status
Filters:
  • Community: Select specific community
  • Resident: Filter by individual resident or “All Residents”
  • Status: Show only Active, Paid, Cancelled, etc.
Sorting:
  • By resident name
  • By date (newest or oldest first)
  • By amount (highest or lowest first)
  • By status

​
Payment Recording

​
Recording Resident Payments

1

Navigate to Payments

Access the “Payments” section and select the community.
2

Create New Payment

Click “New Payment” or “Record Payment”
3

Select Resident

Choose the resident who made the payment
4

Enter Payment Details

Complete the payment form:Payment Information
  • Resident: Who made the payment
  • Payment Date: When payment was received
  • Amount: Payment amount
  • Concept: What the payment is for (optional)
    • Example: “Maintenance fee payment”
    • Example: “Partial payment on special assessment”
Status
  • Por Confirmar (Pending Confirmation): Payment reported but not verified
  • Aplicado (Applied): Confirmed and applied to account
  • Cancelado (Cancelled): Reversed or voided payment
Payment Proof
  • Upload Receipt: Attach bank transfer receipt, check image, or payment confirmation
  • Notes: Add any relevant information
5

Save Payment Record

Click “Save” to record the payment. The system tracks:
  • Who recorded the payment
  • Creation and update timestamps
  • Payment verification status
Uploading payment receipts provides documentation for accounting audits and helps resolve disputes.

​
Payment Methods

The platform can track various payment methods:
  • Bank Transfer: Electronic transfers with receipt upload
  • Check: Physical checks (record check number in notes)
  • Cash: Cash payments (ensure proper receipting)
  • Online Portal: Payments through integrated payment gateways
  • Automatic Debit: Recurring automatic withdrawals
Document the payment method in the “Notes” field for record-keeping and resident preference tracking.

​
Payment Workflow

1

Resident Submits Payment

Resident makes payment through:
  • Bank transfer to community account
  • Check delivery to office
  • Online payment portal
  • Cash at administration office
2

Record Payment

Administrator records the payment as “Por Confirmar” (Pending) with uploaded proof
3

Verify Payment

Review bank statements or receipts to confirm payment received
4

Apply Payment

Change status to “Aplicado” (Applied):
  • Update resident’s balance
  • Mark related charges as paid
  • Send confirmation to resident

​
Viewing Payment History

The payments list shows:
  • Resident Name: Who made the payment
  • Unit Number: Resident’s address
  • Payment Date: When paid
  • Amount: Payment amount
  • Status: Verification status (Pending, Applied, Cancelled)
  • Concept: Payment description
  • Receipt: Link to uploaded proof

​
Balance Management

​
Calculating Resident Balances

For each resident: 
Current Balance = (Sum of Active Charges) - (Sum of Applied Payments)
Example:
  • Charges: 500(Janfee)+500 (Jan fee) + 500 (Feb fee) + 50(Latefee)=50 (Late fee) = 1,050
  • Payments: 500(Janpayment)+500 (Jan payment) + 300 (Partial Feb payment) = $800
  • Balance: 1,050−1,050 - 800 = $250 owed

​
Viewing Resident Accounts

Access complete resident account information:
  1. Navigate to “Payment History” or “Resident Accounts”
  2. Select the resident
  3. View detailed breakdown:
    • All charges (with dates and descriptions)
    • All payments (with dates and amounts)
    • Current balance
    • Payment history timeline
Residents can typically view their own account balance and history through their portal, promoting transparency.

​
Delinquency Management

​
Identifying Delinquent Accounts

Generate reports for accounts with outstanding balances:
1

Access Delinquency Report

Navigate to “Reports” > “Delinquent Accounts” or “Morosos”
2

Review Outstanding Balances

The report shows:
  • Residents with balances over a threshold
  • Number of months delinquent
  • Total amount owed
  • Last payment date
3

Take Action

Follow community collection procedures:
  • Send payment reminders
  • Apply late fees (if policy allows)
  • Schedule payment plans
  • Escalate to legal action if necessary
Follow all local laws and community bylaws when handling delinquent accounts. Document all communication and actions taken.

​
Financial Reports

​
Available Reports

Payment History

Complete payment history for a resident or community, showing all transactions over time

Outstanding Balances

List of all residents with current balances, sorted by amount or delinquency period

Income Report

Total payments received over a date range, broken down by payment type or resident

Aging Report

Accounts receivable aged by 30, 60, 90+ days past due

​
Generating Reports

1

Select Report Type

Choose the report you need from the Reports menu
2

Set Parameters

Configure report filters:
  • Date range (start and end dates)
  • Community (specific or all)
  • Resident (specific or all)
  • Status filters (paid, pending, etc.)
3

Generate and Export

Run the report and export to:
  • PDF for printing or distribution
  • Excel for further analysis
  • CSV for accounting software import

​
Best Practices

Perform monthly reconciliation:
  • Compare platform records to bank statements
  • Verify all payments are recorded
  • Ensure all charges are applied
  • Resolve discrepancies immediately
  • Document reconciliation in meeting minutes
Keep residents informed:
  • Send monthly statements showing charges and payments
  • Provide payment instructions and account details
  • Notify of upcoming special assessments
  • Confirm payment receipt promptly
  • Explain late fees and collection procedures
Establish regular procedures:
  • Generate monthly maintenance fees on the same date
  • Use consistent descriptions for recurring charges
  • Set up batch processes for community-wide charges
  • Review charges before sending statements
Verify payments systematically:
  • Review uploaded receipts for authenticity
  • Cross-check with bank deposits
  • Update status from Pending to Applied only after confirmation
  • Document any payment issues or disputes
Maintain proper records:
  • Upload payment receipts for all transactions
  • Document reasons for cancelled charges or payments
  • Keep notes on payment plans or special arrangements
  • Preserve records for required retention period
  • Enable easy audit access

​
Payment Plans

​
Setting Up Payment Arrangements

For residents with large balances:
1

Negotiate Terms

Work with the resident to establish:
  • Total amount owed
  • Payment schedule (weekly, monthly)
  • Amount per installment
  • Duration of plan
  • Consequences of missed payments
2

Document Agreement

Create a written payment plan:
  • Signed by resident and administrator
  • Uploaded to resident’s document section
  • Include plan terms in charge notes
3

Track Progress

Monitor payment plan compliance:
  • Mark planned payment dates
  • Record each installment payment
  • Send reminders before due dates
  • Address missed payments promptly

​
Integration with Banking

​
Bank Account Management

Some platforms include bank balance tracking:
  • Record bank account balances regularly
  • Compare collected payments to bank deposits
  • Track fees and bank charges
  • Generate bank reconciliation reports
Refer to your specific implementation for bank account integration features.

Build docs developers (and LLMs) love

Get started for freeTalk to us