All Docs
FeaturesagentOS Direct DebitUpdated March 20, 2026

Mandate Detail Page & Timeline — v1.0.79

Mandate Detail Page & Timeline

Introduced in: v1.0.79

The mandate detail page provides a single, consolidated view of everything associated with a Direct Debit mandate — from tenant and bank details through to collection history, fund movements, verification records, and a full audit timeline.

Accessing the Page

The mandate detail page is available at:

/dashboard/mandates/[id]

Replace [id] with the mandate's unique identifier. Links to individual mandates are available from the mandates list view.

Page Sections

Mandate Summary

The top of the page displays core mandate information:

FieldDescription
Tenant DetailsFull name, contact information, and address
Bank DetailsSort code and account number, masked for security
Mandate StatusCurrent status (e.g. active, suspended, cancelled, failed)
Modulr ReferenceThe reference assigned by Modulr at mandate registration
AUDDIS Submission DateThe date the mandate was submitted to BACS via AUDDIS

Note: Bank details are always displayed in masked format (e.g. ●●–●●–12, ●●●●5678) to protect sensitive data. Full account details are never shown in the UI.

Collection History

A complete record of all BACS collection attempts associated with the mandate, displayed in reverse chronological order.

Each collection entry shows:

  • Date — the scheduled and actual collection date
  • Amount — the amount collected (or attempted)
  • Status — one of: submitted, collected, failed, clawed back

This section allows agents and support staff to quickly identify failed or disputed collections without querying the API.

Fund Sweep Records

Displays each sweep event where collected funds were transferred from the Modulr collection account into the Griffin DD holding account. Sweep records are linked to their corresponding collection where applicable.

Clawback Events

Lists any clawback events raised against the mandate — instances where a tenant's bank reversed a previously collected Direct Debit. Each event includes the date, amount, and current resolution status.

Verification Records

Video Verification

A Play button is displayed if a video verification recording exists for the mandate. Clicking it plays back the tenant's recorded verification video — a short clip of the tenant stating their name, the collection amount, and the property or purpose. This recording is stored for fraud protection and dispute resolution.

ID Verification

The result of the tenant's ID verification check is displayed inline, including the overall outcome and submission date.

Mandate Timeline

The timeline section provides a full chronological audit trail of every state transition the mandate has passed through.

Each timeline entry includes:

  • Timestamp — exact date and time of the transition
  • State change — the previous and new status
  • Actor — who or what triggered the transition (e.g. tenant, agent, system)

Example timeline entries:

[2025-01-15 09:03 UTC]  system       Mandate created → pending_submission
[2025-01-15 09:04 UTC]  system       pending_submission → submitted_to_auddis
[2025-01-17 08:00 UTC]  system       submitted_to_auddis → active
[2025-01-28 14:22 UTC]  agent        active → suspended
[2025-01-29 10:05 UTC]  agent        suspended → active

The timeline is particularly useful for audits, dispute resolution, and diagnosing unexpected mandate states.

Use Cases

  • Support queries — quickly review a tenant's full mandate history without switching between views
  • Dispute resolution — use the timeline and clawback events to reconstruct what happened and when
  • Fraud review — play back the video verification and review the ID check result in context
  • Compliance auditing — the full timeline with actors satisfies audit trail requirements for Direct Debit mandates