Agency wholesale billing and unpaid lock

Go to `/dashboard/agency/billing`. Agency Staff cannot access billing.

These invoices are ProfilePilot → your agency (wholesale). They are not the invoices you send your clients at retail — you bill clients separately.

Each invoice shows base licence, unique storefront counts, USD maths, and presentment totals in your agency currency when FX was stamped.

Canonical per unique storefront rates (USD):

| Tier | Typical band | Rate USD | | --- | --- | --- | | Starter | 50–500 | $3.00 | | Growth | 501–1000 | $2.40 | | Scale | 1001–2500 | $1.95 | | Pro | 2501–5000 | $1.50 | | Enterprise | 5001+ | $1.20 |

Plus the monthly base agency licence (public programme figure $199/month unless your contract differs). Rates are USD-canonical; PayFast may collect in presentment currency using stamped FX — multi-currency collection does not replace FX maths.

Your agency may show a negotiated rate instead of a tier label when configured by ProfilePilot.

1. Open the invoice row.
2. Use Pay / payment link (or regenerate if expired — FX may restamp).
3. Complete PayFast checkout. Foreign-currency PayFast purchases are card-only (Instant EFT and similar SA methods are ZAR-only).
4. Optionally Download PDF or Email the invoice (ProfilePilot-branded supplier docs).

Paying sets the invoice paid / balance due to zero and restores access if you were in unpaid lock.

If an invoice stays unpaid:

1. On due date — agency `billing_status` moves to suspended. Agency staff lose `/dashboard/agency` and client switching. Client end-users can still work.
2. Due date + 7 days — managed client orgs may be paused with reason agency invoice overdue. Clients see an agency-overdue message (not a retail `/pricing` wall).
3. Payment restores the agency immediately and unsuspends only clients paused for that overdue reason. Clients suspended for other reasons stay suspended.

Unpaid lock is reversible. It is not offboarding.

Platform / special billing modes (for example internal platform agencies or external-quote enterprises) are never swept by wholesale unpaid handling — only clients linked to a wholesale-billed partner agency.