Reserve Status & Holding Account Dashboard Widget
Reserve Status & Holding Account Dashboard Widget
Introduced in v1.0.80, the Reserve Status & Holding Account widget gives operators a real-time summary of fund-holding health directly from the main dashboard overview page.
Overview
Funds collected via Direct Debit pass through a Griffin holding account before being forwarded to an agent's client account. During the hold period, a clawback reserve must be maintained to cover any potential reversals from tenants' banks. This widget makes the state of that holding account immediately visible without navigating away from the dashboard.
Widget Contents
| Field | Description |
|---|---|
| Holding Account Balance | The current total balance in the Griffin DD holding account. |
| Required Clawback Reserve | The minimum reserve amount calculated using the configured risk factor and threshold for the customer. |
| Available to Forward | Holding Balance − Required Reserve. Funds in this amount are eligible to be forwarded to the agent's client account. |
| Upcoming Forward Payments | Forward payments scheduled to execute within the next 24 hours. |
| Reserve Health Indicator | A traffic-light status showing reserve health at a glance. |
Reserve Health Indicator
The indicator uses three states to communicate reserve health:
- 🟢 Green — The holding account reserve meets or comfortably exceeds the required minimum. Forwarding can proceed normally.
- 🟡 Amber — The reserve is approaching the minimum threshold. Monitor closely; forwarding may be constrained soon.
- 🔴 Red — The reserve has dropped below the required minimum. Forwarding is blocked until the reserve is restored.
Auto-Refresh
The widget refreshes automatically every 5 minutes. This ensures that balance and reserve figures remain current throughout the working day without requiring a manual page reload.
Fund Flow Report
The widget includes a direct link to the full fund flow report, which provides a detailed breakdown of:
- Collection history
- Sweep transactions (Modulr → Griffin)
- Forwarding history (Griffin holding → agent client account)
- Clawback events and reserve adjustments
Use the fund flow report for audit purposes or to investigate specific transactions flagged by the reserve health indicator.
Data Source
Widget data is served via a dedicated tRPC endpoint. The endpoint returns a snapshot of the holding account state, including balance, reserve figures, and upcoming scheduled forwards, scoped to the authenticated customer (letting agent).
Location
The widget is displayed prominently on the main dashboard overview page. No additional navigation is required to access it.