Amendment status change notification

Sent to the notification URL provided during mandate creation.

TypeDescription
mandate_amendment_requestedAmendment request submitted to the provider
mandate_amendedAmendment approved and applied. BILATERAL: payer approved. UNILATERAL: auto-approved
mandate_amendment_declinedPayer declined the amendment
mandate_amendment_request_abandonedAmendment request timed out
mandate_amendment_failedAmendment processing failed

Header Parameters

Content-Type*string

Content type.

Default"application/json"
User-Agent*string

User agent.

Default"Volt/2.0"
X-Volt-Timed*integer

Timestamp of notification generation.

X-Volt-Signed*string

Notification signature.

X-Volt-Type*string

Type of amendment notification.

Value in"mandate_amendment_requested""mandate_amended""mandate_amendment_declined""mandate_amendment_request_abandoned""mandate_amendment_failed"

Request Body

application/json
  1. body

Amendment details.

id*string

Amendment identifier.

Formatuuid
mandateId*string

Mandate identifier.

Formatuuid
track*AmendmentTrackEnum

Amendment track. Bilateral changes require payer approval; unilateral changes do not.

Value in"BILATERAL""UNILATERAL"
initiator*AmendmentInitiatorEnum

Who initiated the amendment.

Value in"CUSTOMER""PAYER"
status*

Amendment status.

changes*

Proposed constraint changes.

createdAt*string

When the amendment was created.

Formatdate-time
updatedAt?|

When the amendment was last updated.

Formatdate-time

Response Body

OK

application/json
  1. response
Example Requests
POST/Amendment status change
Request Body
application/json
{  "id": "79fb2306-e199-497e-b5a1-912a68a02894",  "mandateId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",  "track": "BILATERAL",  "initiator": "CUSTOMER",  "status": {    "status": "AWAITING_APPROVAL",    "details": null  },  "changes": {    "validity": {      "to": "2026-08-31 00:00:00"    },    "payTo": {      "limits": {        "payment": {          "amount": 12000        }      }    }  },  "createdAt": "2026-04-10T12:00:34+00:00",  "updatedAt": "2026-04-10T12:00:34+00:00"}
Header Parameters
{  "Content-Type": "application/json",  "User-Agent": "Volt/2.0",  "X-Volt-Timed": 0,  "X-Volt-Signed": "string",  "X-Volt-Type": "mandate_amendment_requested"}