Mandate Registration with Modulr — AUDDIS Submission Now Live
Mandate Registration with Modulr — AUDDIS Submission Now Live
Release v1.0.25
With v1.0.25, the Direct Debit collection service now completes the full mandate setup journey: when a tenant submits the mandate form, their bank details are immediately registered with Modulr via the AUDDIS API — the standard mechanism for setting up Direct Debit mandates on the BACS network.
This release closes the loop between the tenant-facing mandate form and the live BACS mandate registration, making end-to-end collection scheduling possible for the first time.
What This Means in Practice
Before v1.0.25: A tenant could complete the mandate form, but their bank details were not yet forwarded to Modulr. No live mandate existed on the BACS network.
From v1.0.25 onwards: Form submission triggers an AUDDIS registration call to Modulr in real time. The resulting Modulr mandate reference is stored immediately, and the mandate transitions to active once the BACS network confirms acceptance (typically within one to two banking days via webhook or poll).
Key Details for Integrators
Mandate Status Changes to Track
If you are consuming the mandate API, you should handle two new status values introduced or formalised in this release:
| Status | When to expect it |
|---|---|
pending_submission | Immediately after the tenant submits the mandate form |
active | After Modulr confirms BACS network acceptance (async, via webhook or poll) |
Poll the mandate endpoint or listen for webhook events to know when a mandate is ready for collection scheduling.
Agent Notification
The assigned letting agent receives an automated notification when a mandate transitions to active. No manual polling is required on the agentOS side — the notification is the signal that the mandate is live.
Modulr Mandate Reference
Once a mandate is active, it will carry a modulr_mandate_reference field. Store or forward this reference if you need to correlate mandate records with Modulr's own reporting or support processes.
Next Steps
With mandate registration in place, the next milestones in the fund flow are:
- Collection scheduling — submitting a BACS collection request against an active mandate
- Sweep to Griffin — moving collected funds from the Modulr account to the Griffin DD holding account
- Hold & forward — applying the clawback hold period before releasing funds to the agent's client account
See the full feature documentation for technical details on the AUDDIS submission flow.