Amend BACS paper mandate [beta]

Amend a BACS direct debit paper mandate.

Registers a change to a paper mandate's debtor and/or beneficiary details, applied asynchronously through the BACS scheme.

Notes:

  • The amend is persisted with status = AMEND_PENDING, and enqueued for the asynchronous submission worker, which submits it to Form3 through the PSP gateway.

  • Allowed only when the mandate is in CREATED, SUBMITTED, or CONFIRMED; any other state is rejected with a 409 Conflict (EBACS0103).

  • version is a Form3 optimistic-concurrency passthrough that must equal the stored version; a mismatch is rejected with a 409 Conflict (EBACS0104). It is not incremented by this call.

  • This endpoint moves the mandate to status = AMEND_PENDING and generates a BACS paper mandate status changed event. Subsequent status transitions generate further events (for example AMENDED, FAILED).

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required
length ≤ 36

Paper mandate ID (the Form3-assigned ID returned at creation).

Body Params

Amend paper mandate request body

Payload to amend an existing paper mandate. version is required for optimistic concurrency.

integer
required

Caller's expected current mandate version. A Form3 optimistic-concurrency passthrough that must match the stored version; it is not incremented by this call.

debtor
object

Debtor (payer) bank details captured from the signed paper mandate form.

beneficiary
object

Beneficiary (creditor) details. Account number and sort code are optional paying-bank details.

Headers
string
required

Account token - token encoded with a Pismo account ID. Tokens can expire quickly, which can result in a 401 Unauthorized message

Responses

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json