Your estate configuration defines how your community is structured, what electricity rate is billed, and how resident payments are routed.
/api/method/m6.api.payment_webhook. Test with test keys before switching to live keys.
Every physical apartment, duplex, or commercial unit is registered as a Property.
FLAT-3B or HOUSE-12) — M6 assigns the unique Property ID automatically.0419-8274-192). Meter numbers must be unique — duplicates are rejected. Power tokens purchased for the property generate exclusively for this meter.How to Link a Resident in 3 Quick Clicks:
-
1Open the Property DocumentNavigate to Property (or press Ctrl+K > Property) and open the resident's house (e.g.
UNIT-B04). -
2Select Resident in the DropdownIn the Resident field, select the resident's registered name or email from the list.
-
3Click SaveThe moment you click Save, the resident's mobile app and web dashboard unlock automatically with full access to power vending, wallet top-ups, and visitor passes.
Approving Self-Service Signups:
When a resident registers online at /signup, their record appears under Resident with status Pending. Open their profile, verify their phone and allocated unit, then click Approve. M6 records who approved the signup and when, activates the resident's login, and emails their welcome details. To refuse a signup, click Reject. Statuses are Pending → Active (approved), Suspended, or Rejected.
M6 simplifies property leasing by tracking property owners, tenancy agreements, rent collection schedules, and automated landlord disbursements.
Bill residents for monthly estate levies, security charges, waste disposal, and ad-hoc maintenance without manual paperwork.
| Billing Method | When to Use It | How to Execute in M6 |
|---|---|---|
| Estate Bill Profile | Standard recurring monthly charges (e.g. Security Levy ₦20,000/mo). | Set up once in Billing > Estate Bill Profile. The system generates bills automatically every month. |
| Batch Court Billing | Generate bills for many properties in a specific court or the entire estate at once. | Open Generate Court Batch Bill or Generate Estate Batch Bills, select the Court/Estate and posting date, then submit (with approvals enabled, the batch executes when approved). |
| Single Property Bill | One-off charges (e.g. clubhouse event fee, plumbing repair, construction levy). | Open Estate Single Property Bill, pick the Property Unit, enter the itemized breakdown and amount, then submit for approval (see section 7). |
Billing documents can be protected by a maker-checker approval chain: the person who creates a bill cannot approve it, and (optionally) a second person must approve it. Approval is what executes the bill — invoices are dispatched, wallets are debited, and residents are notified only when the final approval lands.
| Stage | Who Does It | What to Do / What Happens |
|---|---|---|
| 1. Draft | Maker (billing officer) | Create the bill — Estate Single Property Bill, Generate Court Batch Bill, or Generate Estate Batch Bills — and click Submit for Approval. |
| 2. Pending M6 Approval | First checker | The bill waits in the approvers' queue. The maker cannot approve their own bill. Click Approve — or Reject with a reason (rejection cancels the bill and reverses anything already posted). |
| 3. Pending Second Approval | Second checker (a different person) | Appears only when the estate's approval config requires two approvals. The first approver's OK moves the bill here. |
| 4. Approved | System | Final approval executes the bill: the Sales Invoice is created and submitted, the wallet auto-debit is applied, and the resident is notified by email and push. |
The Service Lockout feature is an automated compliance mechanism. It enforces timely payment of estate service levies without gate confrontations. There is no grace period: lockout applies the moment a bill is due and unpaid, and lifts the moment payment lands.
• Power Vending Blocked: Resident cannot purchase electricity.
• Visitor Gate Passes Blocked: Resident cannot create guest QR passes.
• Amenity Bookings Blocked: Resident cannot reserve shared facilities.
What Managers Can Do for a Locked Property:
There is no manual lockout override — the lockout clears only when the debt is settled. While a unit is locked, the office can still serve the resident through Emergency Power Vending (see section 11): the office records the payment itself and vends power on the spot, even for a locked property.
Test how the M6 compliance engine evaluates overdue days, applies service lockouts, and immediately restores privileges upon settlement:
Visitor Gate Passes: Blocked ❌
Amenity Bookings: Blocked ❌
Resident App Screen: "Overdue Service Levy (₦35,000.00). Settle bill to restore services."
To eliminate financial disputes, M6 maintains 3 separate sub-wallets for each property. This ensures electricity money cannot accidentally pay waste charges, and maintenance funds are never locked inside utility meters.
| Wallet Category | Dedicated Purpose | Typical Debits & Credits |
|---|---|---|
| Energy Wallet | Prepaid smart electricity meter tokens. | Funded by resident → Debited when purchasing 20-digit electricity STS tokens. |
| Service Wallet | Routine estate maintenance and service levies. | Funded by resident → Debited for monthly security levies, waste disposal, and clubhouse bookings. |
| Estate Contribution | Special capital improvement levies. | Funded by resident/landlord → Debited for perimeter CCTV upgrades, road asphalt repair, and solar streetlights. |
M6 charges estates three platform fees, settled through the estate's Platform Wallet (the corporate wallet held with M6):
| Fee | How It Is Charged | Amount (currently) |
|---|---|---|
| Monthly Subscription | Per active property, debited from the platform wallet on the 1st of each billing cycle. | ₦1,500 / property / month |
| Power Vending Commission | Flat fee per power vend, recorded against the platform wallet. | ₦200 / vend |
| Rental Commission | Percentage of the estate's management fee on each rent payment. | 0.5% |
Residents buy power online through the app, under rules set on your Estate document. Review them under the estate's power settings so you can explain charges to residents:
| Rule | Estate Setting | Effect on Resident Vending |
|---|---|---|
| Vending Fee | Power Vending Fee | Deducted from every vend — units are calculated on the amount minus the fee. |
| Minimum Purchase | Min Purchase Limit | Smallest amount a resident can vend (₦1,000 floor when unset). |
| Monthly Cap | Max Purchase Limit | Maximum a property can spend on power per calendar month (0 = no cap). |
| Monthly First-Buy Minimum | Enable Monthly First Buy + Must Purchase Amount | When on, the first power purchase of each calendar month must be at least the must-purchase amount. |
Office (Emergency) Vending
When a resident visits the estate office to purchase electricity with cash, POS, or bank transfer — even for a locked property — use the Emergency Power Vending desk. Office vending bypasses the rules above, so record each payment carefully:
-
1Open Emergency Power VendingPress Ctrl + K and type "Emergency Power Vending". Available to System Manager, Tenant Admin, Facility Manager, Estate Manager, and M6 Manager.
-
2Select Property & Enter AmountPick the unit (e.g.
FLAT-3B). The resident name and meter number load automatically. Enter the amount the resident is paying. -
3Record the PaymentEnter the payment reference (bank transfer ref, POS receipt number, or your cash receipt number) — the office collects and settles this money offline. Optionally check Debit resident energy wallet to take the amount from their wallet instead.
-
4Vend & Deliver the TokenClick Vend Power. The 20-digit token is generated through the estate's vending provider and delivered to the resident by SMS and email. If the provider is unreachable, M6 falls back to a locally generated emergency token so the resident still gets power — reconcile with the provider afterwards.
Estate Tariff: ₦150.00 / kWh
Vending Fee (deducted): ₦100.00
M6 POWER TOKEN: 5819-2049-5819-2049-5819. Units: 66.67kWh (N10,000.00). Meter: 0419-8274-192.
Estate security personnel use the lightweight, touch-screen Security Gate Terminal on smartphones or guardhouse tablets.
Provisioning Security Guards:
Before guards can use the terminal, add each officer under Security Guard: name, guard ID, the guard's user login, assigned estate, gate station (e.g. Main Gate — Inbound), and status Active. The terminal only works for guards registered this way.
482-109).| Service Module | How It Works | Manager Action |
|---|---|---|
| Maintenance Tickets | Residents report plumbing, electrical, civil, or security faults by category with a description. Tickets move Open → Assigned → In Progress → Awaiting Parts → Resolved → Closed. | Set priority, assign a vendor (supplier), record the cost, and mark resolved — optionally charging the cost back to owner or tenant. |
| Amenity Bookings | Residents book shared facilities (Clubhouse Hall, Tennis Court, Swimming Pool, Guest Suites) for a date and time slot; a booking fee applies. | Review requests and confirm (Pending → Confirmed), or cancel when the slot is not available. |
Generate real-time financial statements for executive committee (EXCO) meetings and audits:
| Report Name | What It Shows | Recommended Frequency |
|---|---|---|
| M6 Wallet Balances | Snapshot of every property unit: Energy, Service, and Estate Contribution balances, meter number, lockout flag, and resident — with estate totals. | Weekly Operations Review |
| M6 Power Transactions | Audit list of all 20-digit tokens generated, meter IDs, purchase amounts, and kilowatt-hours vended. | Weekly Utility Reconciliations |
| M6 General Ledger | Every wallet ledger entry across properties: type, purpose, sub-wallet, amount, and reference, with debit/credit totals. | Monthly Financial Audit |
| M6 Service & Estate Contribution | Service-charge and estate-contribution entries across the estate. | Monthly Financial Audit |
| Estate Consolidated Wallet and Utility Summary | Per-estate: total units vended, wallet pool, power revenue, kWh yield, and gate-pass counts — with a chart. | Monthly EXCO Meeting |
Also available when you need them: Amenity Bookings, Gate Pass, Landlord Directory, Maintenance, Tenancy, Election Results, and Poll Results reports.