All Docs
FeaturesagentOS Direct DebitUpdated March 13, 2026

Introducing the Public Tenant Mandate Form

Introducing the Public Tenant Mandate Form

Release: v1.0.16

With v1.0.16, the Direct Debit collection service now includes the public-facing tenant mandate form — the end-to-end journey that turns a letting agent's invite into a live, registered Direct Debit mandate.

How It Works

A letting agent generates a mandate invite link from the API. That link is sent to the tenant. When the tenant opens it, they land on /mandate/[token] — a public page that requires no login or account.

On load, the service:

  1. Validates the token — confirming it is genuine, unexpired, and unused.
  2. Fetches the mandate invite context — including agent configuration and mandate type (property vs. non-property).
  3. Renders the multi-step wizard, tailored to the mandate type.

The Multi-Step Wizard

The form is structured as a progressive, step-by-step wizard with a visible progress indicator so tenants always know where they are in the process.

Steps Overview

Step 1 — Personal Information The tenant provides their name, address, and contact details.

Step 2 — DD Terms & Conditions The tenant reviews and accepts the Direct Debit Guarantee — a mandatory regulatory step.

Step 3 — Payment Details Covers the collection amount, payment frequency, and scheduled collection date. Working day logic is applied here so tenants see accurate, BACS-aligned dates.

Step 4 — Bank Details The tenant enters their account number, sort code, and account holder name.

Step 5 — Video Verification The tenant records a short video stating their name, the collection amount, and the property or purpose. This is retained as a fraud protection record.

Step 6 — ID Verification Identity is verified via a third-party provider integration.

Step 7 — Right to Rent (property mandates only) For tenancies that require it, this step captures the Right to Rent check. It is automatically skipped for non-property mandates.

Step 8 — Confirmation The tenant reviews all entered information before final submission.

Token Expiry & Error Handling

If a tenant opens a link that has already been used or has expired, the form handles this gracefully — displaying a clear, informative error state rather than a broken or confusing page. Agents can issue a new invite link via the API if needed.

Mandate Variants

The wizard supports two mandate types:

TypeRight to Rent Step
Property mandateShown (Step 7)
Non-property mandateSkipped automatically

The correct variant is determined at token validation time from the mandate invite context — no configuration is needed by the tenant.

What's Next

This release delivers the wizard shell — token validation, step state management, and progress rendering. Subsequent releases will fill in the business logic, validation, and submission handling for each individual step.