Amend or cancel a previously created BACS direct debit paper mandate.
The requested operation is validated against the mandate's current status and version, the pending intent is persisted with an optimistic-lock version bump, and the operation is enqueued for the asynchronous submission worker to forward to Form3. The endpoint does not call Form3 directly.
State rules:
amendis allowed only fromCREATED,SUBMITTED, orCONFIRMED, and moves the mandate toAMEND_PENDING.cancelis allowed only fromSUBMITTEDorCONFIRMED, and moves the mandate toCANCEL_PENDING.- An invalid source state returns 409 Conflict.
Optimistic concurrency: the caller sends the version it last observed. If it does not match the stored version, or the mandate is modified concurrently, the request is rejected with 409 Conflict. On success the version is incremented by 1.
This endpoint generates a BACS paper mandate status changed event with status = AMEND_PENDING (amend) or CANCEL_PENDING (cancel).
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||