Mandate webhook specifications
Payment notifications sent to your webhook URI registered in the console, when a mandate becomes authorized, fails, or is revoked.
mandate_authorized
Notification that a mandate has been authorised
Field | Type | Description |
---|---|---|
type | string | Type of the event ("mandate_authorized" ) |
event_id | string | A UUID for the event |
event_version | string | The version of the event schema |
mandate_id | string | The unique ID for the mandate |
authorized_at | datetime | An RFC-3339 timestamp of when the mandate was authorized |
metadata | object | Custom key-value data supplied during mandate creation |
mandate_failed
Notification that a mandate has failed to be created
Field | Type | Description |
---|---|---|
type | string | Type of the event ("mandate_failed" ) |
event_id | string | A UUID for the event |
event_version | string | The version of the event schema |
mandate_id | string | The unique ID for the mandate |
failed_at | datetime | An RFC-3339 timestamp of when the mandate failed to be authorized |
failure_stage | string | An enum identifying where the mandate failed in it's lifecycle. Can be one of "authorization_required" , "authorizing" , "authorized" |
failure_reason | string | The reason the payment failed. Example values to expect: "authorization_failed" , "provider_error" , "provider_rejected" , "internal_server_error" , "invalid_sort_code" , "invalid_request" , "unknown_error" . Implementations should expect other values, since there may be more failure reasons added in future |
metadata | object | Custom key-value data supplied during mandate creation |
mandate_revoked
Notification that a mandate has been revoked
Field | Type | Description |
---|---|---|
type | string | Type of the event ("mandate_revoked" ) |
event_id | string | A UUID for the event |
event_version | string | The version of the event schema |
mandate_id | string | The unique ID for the mandate |
revoked_at | datetime | An RFC-3339 timestamp of when the mandate was revoked |
revocation_source | string | An enum identifying who revoked the mandate. Can be one of "client" , "provider" |
metadata | object | Custom key-value data supplied during mandate creation |
Updated 4 months ago