Account & Alias lifecycle
Receive real-time webhooks when accounts and aliases change state — suspension, reactivation, and closure.
Account lifecycle notifications tell you when an account or one of its aliases changes state. See for enabling, testing, and delivery details common to all channels.
Types of notifications
| Notification | Description | X-Volt-Type header value |
|---|---|---|
| Account suspended | An account was suspended and can no longer transact. | account_suspended |
| Account reactivated | A suspended account was reactivated. | account_reactivated |
| Account closed | An account was permanently closed. | account_closed |
| Alias closed | An alias was permanently closed. | alias_closed |
Configuration and overrides
Only account closed and alias closed can override the destination URL per request, via a communication field on the close request. Account suspended and account reactivated always use the Fuzebox default. For the general setup — Fuzebox configuration, the override payload, and delivery — see .
The payload mirrors the resource itself, so it is identical to the GET response for that account or alias. Account events carry the full account resource. The alias closed event carries the full alias resource.
Account state changed
Sent for account suspended, account reactivated, and account closed. The payload is the account resource, with status and active reflecting the new state.
Prop
Type
{
"id": "5399e2e9-2693-48a6-bc35-fe4a827d936c",
"currency": "EUR",
"identifications": [
{ "iban": "DE23874043682755038080" }
],
"name": "Main collection account",
"active": false,
"status": "SUSPENDED",
"balance": {
"available": 125000,
"timestamp": "2026-06-25T10:00:00Z"
},
"type": "VOLT_ACCOUNT",
"subType": "BUSINESS",
"accountHolder": {
"entityId": "3ddba750-89e7-45a2-bdc9-99d12018aa34",
"legalName": "Your Company Ltd"
}
}Alias closed
Sent when an alias is closed. The payload is the full alias resource, with active always false for a closed alias.
Prop
Type
{
"id": "461f934c-565f-4ae0-9045-cf89b121d619",
"currency": "EUR",
"identifications": [
{ "iban": "DE34202208000026239222" },
{ "iban": "DK5489000026239222" },
{ "iban": "GB58SAPY60838226239222" },
{ "iban": "LU644080000026239222" },
{
"accountNumber": "26239222",
"sortCode": "608382"
}
],
"customerId": "3ddba750-89e7-45a2-bdc9-99d12018aa34",
"accountId": "cf44198d-e86b-406a-9b73-86a24c5c9a4c",
"orderId": "76f8f193-71dc-4d72-ab03-c73e062a2a59",
"active": false,
"_links": {
"self": {
"href": "https://accounts.sandbox.volt.io/account-aliases/461f934c-565f-4ae0-9045-cf89b121d619",
"method": "GET"
}
}
}Security and delivery
Lifecycle notifications share the standard Volt webhook envelope, signature, and retry behaviour — see .
How is this guide?
Last updated on