Release Spotlight: Collection Amount Amendment Flow
Release Spotlight: Collection Amount Amendment Flow (v1.0.88)
We've shipped v1.0.88, which adds a complete end-to-end flow for amending the collection amount on an active Direct Debit mandate. Here's what changed and why it matters.
The Problem
Rent amounts change. Rent reviews, service charge adjustments, or correcting an initial setup error all require updating the amount collected via Direct Debit. Previously there was no first-class way to handle this — an agent had to cancel the mandate and create a new one, disrupting the tenant and adding unnecessary operational overhead.
The Solution
v1.0.88 introduces a dedicated amendment flow that handles the BACS complexity for you.
What agents see
In the mandate detail view (or via the API), an agent can submit a new collection amount. The system immediately responds with the effective-from date — the earliest date the new amount can apply, given BACS advance-notice rules. There's no guesswork; the date is calculated automatically.
What tenants see
The tenant receives an advance notification of the change — their name, the new amount, and when it takes effect. This is a legal requirement under the Direct Debit Guarantee, and it's handled automatically by the service.
What happens in the background
An Inngest job watches for pending amendments and submits the AUDDIS amendment message to Modulr at exactly the right point in the BACS processing window. No cron jobs to babysit, no manual intervention required.
Key Design Decisions
- Future-dating the amendment ensures we never violate BACS advance-notice obligations. The existing collection amount remains active until the effective date, so there are no gaps or double collections.
- Immutable amendment record — the pending amendment is stored as a separate record, giving a clear audit trail of what was requested, when it was submitted to Modulr, and when it became effective.
- Inngest for async submission — BACS submission windows are time-sensitive. Using Inngest ensures the job retries reliably if Modulr is temporarily unavailable, without blocking the API response.
Getting Started
The feature is available now. Refer to the Amending a Collection Amount guide for a full walkthrough, and the API Reference for endpoint details.