Credits
Commerce / Credits — Production view
Assign and manage a virtual credit currency that tenants use to pay for services and resource bookings.
Overview
Credits is a building-level virtual currency system. Your property team assigns credit balances to tenants, and tenants spend them through the HqO app on resource bookings and other eligible services. Credits can have expiration dates, letting you run time-limited programs or seasonal promotions.
The dashboard summarizes credit distribution and usage at a glance, and the Credits Management tab lets you manage balances per tenant.
Getting started
Credits must be enabled for your building before they appear in the app. Contact your HqO account team to activate the Credits feature. Once enabled, you can assign balances immediately.
🔒 Permission required: Managing credits requires Commerce permissions in HqO Admin.
Use cases
- Lease inclusion — include credits in the lease agreement as ongoing value instead of one-time concessions or TI-allowance offsets.
- Fair access management — cap credits per tenant so high-demand resources aren't monopolized (e.g., 10 credits per month per tenant).
- Tenant appreciation — offer credits to top tenants or as a goodwill gesture after a building issue.
- Promotional perks — introduce credits to encourage tenants to try paid amenities.
Automation and scope
- Credits can apply across all resources or be limited to specific amenities.
- Recurring distributions support configurable schedules and rollover rules, so allocations renew automatically.
- Tenants see balances in real time and choose between credits or standard payment at checkout.
- Reporting covers allocations, transactions, active users, and top tenants.
Dashboard metrics
| Metric | Description |
|---|---|
| Credits | Credits assigned vs. total pool (e.g., "0 of 129,902") with remaining balance shown below |
| Transactions | Number of credit transactions in the last 30 days |
| Active users | Users utilizing credits in the last 30 days |
| Total tenants | Tenant companies across all buildings |
| Top tenant | Tenant that used the most credits in the last 30 days |
Tabs
| Tab | Description |
|---|---|
| Credits management | Per-tenant view of credit balances, expiration dates, and descriptions |
| Usage report | Credit consumption analytics over time |
Core workflows
Assign credits to a tenant
- Go to HqO Admin > Commerce > Credits.
- Click the Credits management tab.
- Click Assign credits (top right button).
- Select the tenant, enter the credit amount, and set an expiration date if applicable.
- Add an optional description (e.g., "Q2 amenity credits").
- Click Save. The tenant's balance updates immediately.
View a tenant's credit balance
- Go to the Credits Management tab.
- Find the tenant in the list. Their current balance, expiration date, and description are shown in the row.
Review credit usage
- Click the Usage report tab.
- Filter by date range and tenant to see how credits are being spent.
FAQ
What can tenants spend credits on? Tenants can use credits toward resource bookings and other services you've configured as credit-eligible. Eligible items are set up during your HqO Commerce configuration.
Do credits expire? Credits expire only if you set an expiration date when assigning them. Credits without an expiration date remain active until spent.
Can I take credits back from a tenant? Yes. Edit the tenant's credit balance from the Credits Management tab and adjust the amount downward.
What happens when a tenant's credits expire? Expired credits are removed from the tenant's balance and cannot be used. They remain visible in usage history for reporting purposes.