All Docs
FeaturesDepositClearUpdated March 9, 2026

Deposit Release Workflow

Deposit Release Workflow

Available from v0.1.31

The Deposit Release Workflow provides a structured, audited process for distributing deposit funds at the end of a tenancy. It ensures all parties agree on the proposed split before any funds are released through the deposit scheme.

How It Works

The workflow follows three sequential stages:

1. Agent Proposes a Split

The agent creates a deposit release proposal by specifying how the total deposit should be allocated:

FieldDescription
Return to TenantThe amount to be refunded to the tenant.
Amount to LandlordThe amount to be paid to the landlord (e.g. to cover unpaid rent or damage).
DeductionsItemised deduction amounts, broken down by reason.

The sum of all fields must equal the total deposit held by the scheme.

2. All Parties Acknowledge

Once the proposal is submitted:

  • Both the landlord and the tenant are notified of the proposed split.
  • Each party must explicitly acknowledge the proposal.
  • The agent can monitor acknowledgement status in real time.
  • The release action remains locked until all required acknowledgements are received.

Note: Acknowledgement is not the same as agreement to dispute. It confirms each party has reviewed the proposed split. Dispute workflows are handled separately.

3. Agent Initiates Release

Once all parties have acknowledged:

  • The agent can trigger the formal release through the deposit scheme.
  • This action is only available after acknowledgements are complete — it cannot be bypassed.
  • The platform submits the release instruction to the scheme on behalf of the agent.

Audit Trail

Every deposit release creates a permanent audit record containing:

  • The agreed allocation amounts (tenant return, landlord amount, deductions)
  • The identity and timestamp of each party's acknowledgement
  • The identity and timestamp of the agent's release initiation

This audit record is immutable and can be referenced in any subsequent dispute or compliance review.

Roles & Permissions

ActionAgentLandlordTenant
Create deposit split proposal✅❌❌
Acknowledge proposed split❌✅✅
Initiate scheme release✅❌❌
View audit record✅✅✅

Related