Types of notifications

Notification Type	Description	X-volt-type Header Value
Incoming transaction completed	Account credited successfully.	incoming_transaction_completed
Outgoing transaction completed	Outgoing payment processed successfully.	outgoing_transaction_completed
Outgoing transaction rejected	Outgoing payment failed or rejected.	outgoing_transaction_rejected
Account holder verification result completed	Account holder verification is completed.	account_holder_verification_result_completed

Configuration and overrides

Notification configuration is managed in Fuzebox settings. For individual outgoing payments, the URL can be overridden by passing a communication field in the request:

{
  "communication": {
    "notification": {
      "url": "https://mywebsite.com/webhooks"
    }
  }
}

Incoming webhooks cannot be overridden; they always use the default configuration.

The structure of the JSON payload for both events adheres strictly to the schema of the standard get response.

API Reference

Get transaction details

GET/transactions/{transactionId}

Incoming transactions

Field	Nullable	Description
id	false	Unique UUID of the transaction generated by Volt.
status	false	Status of the transaction.
operation	false	Type of operation: INCOMING).
type	false	Type of transaction Possible values: `GATEWAY_PAYMENT`,`MANUAL_CREDIT`,`TOP_UP`, `BOUNCE_BACK`.
subtype	true	Subtype of transaction.
createdAt	false	The timestamp when the transaction was initially created (ISO 8601).
updatedAt	false	The timestamp of the last status update (ISO 8601).
amount	false	The total value of the transaction represented in minor units.
currency	false	Currency code (ISO 4217).
paymentReference	true	The reconciliation reference that appears on the bank statement.
internalReference	true	Unique identifier of the transaction in the partner's system.
paymentRail	true	The specific infrastructure used to move the funds.
beneficiary	false	The recipient of the funds.
beneficiary.accountIdentifiers	true	Account identifiers (IBAN, etc.).
sender	true	The sender of the funds.
sender.name	true	Full name or legal entity name of the sender.
sender.customerId	true	The unique identifier of the customer in Volt.
sender.accountId	true	The unique identifier of the sender's account.
sender.accountIdentifiers	true	Account identifiers (IBAN, etc.).

Manual credit example:

{
  "id": "f291b32a-1252-494f-ae5b-f487983d9f22",
  "status": "COMPLETED",
  "operation": "INCOMING",
  "type": "MANUAL_CREDIT",
  "createdAt": "2026-01-27T21:21:14.147327Z",
  "updatedAt": "2026-01-27T21:21:15.41338Z",
  "amount": 100,
  "currency": "EUR",
  "paymentReference": "payment-reference",
  "paymentRail": "SEPA_INSTANT",
  "beneficiary": {
    "customerId": "3ddba750-89e7-45a2-bdc9-99d12018aa34",
    "accountId": "5399e2e9-2693-48a6-bc35-fe4a827d936c",
    "name": "Your account name",
    "accountIdentifiers": {
      "iban": "DE23874043682755038080"
    }
  },
  "sender": {
    "name": "Jonathon Adams",
    "accountIdentifiers": {
      "iban": "PL61109010140000071219812874"
    }
  },
  "_links": {
    "self": {
      "href": "/transactions/f291b32a-1252-494f-ae5b-f487983d9f22",
      "method": "GET"
    }
  }
}

Incoming Internal example :

{
  "id": "910a9ccf-e43f-4d8d-9b89-200b8108fbae",
  "status": "COMPLETED",
  "operation": "INCOMING",
  "type": "INTERNAL",
  "createdAt": "2026-01-27T14:20:38.421385Z",
  "updatedAt": "2026-01-27T14:20:38.978899Z",
  "amount": 1,
  "currency": "EUR",
  "paymentReference": "test",
  "internalReference": "internal",
  "paymentRail": "INTERNAL",
  "beneficiary": {
    "customerId": "3ddba750-89e7-45a2-bdc9-99d12018aa34",
    "accountId": "4461eccc-b0d0-41e4-b013-a31b487d4b1f",
    "accountIdentifiers": {
      "iban": "DE16175282381567945827"
    }
  },
  "sender": {
    "name": "Your account name",
    "accountIdentifiers": {
      "iban": "DE23874043682755038080"
    }
  },
  "_links": {
    "self": {
      "href": "/transactions/910a9ccf-e43f-4d8d-9b89-200b8108fbae",
      "method": "GET"
    }
  }
}

}

Outgoing transactions

Field	Nullable	Description
id	false	Unique UUID of the transaction generated by Volt.
status	false	Status of the transaction.
operation	false	Type of operation: OUTGOING.
type	false	Type of transaction Possible values: `PAYOUT`,`SETTLEMENT`,`REFUND`, `INTERNAL`.
subtype	true	Subtype of transaction.
createdAt	false	The timestamp when the transaction was initially created (ISO 8601).
updatedAt	false	The timestamp of the last status update (ISO 8601).
failure	true	Details regarding why a transaction was not successful.
failure.code	true	A standardized machine-readable error code indicating why the transaction failed.
amount	false	The total value of the transaction represented in minor units.
currency	false	Currency code (ISO 4217).
paymentReference	true	The reconciliation reference that appears on the bank statement.
internalReference	true	Unique identifier of the transaction in the partner's system.
paymentRail	true	The specific infrastructure used to move the funds (e.g. SEPA_INSTANT).
beneficiary	false	The recipient of the funds.
beneficiary.name	true	Name of the individual or entity.
beneficiary.email	true	Email address of the beneficiary.
beneficiary.country	true	Country code of the beneficiary.
beneficiary.accountIdentifiers	true	Account identifiers (IBAN, etc.).
beneficiary.address	true	Physical address of the beneficiary.
sender	true	The sender of the funds.
sender.name	true	Full name or legal entity name of the sender.
sender.customerId	true	The unique identifier of the customer in Volt.
sender.accountId	true	The unique identifier of the sender's account.
sender.accountIdentifiers	true	Account identifiers (IBAN, etc.).
verifications	true	Group of verification results.
verifications.accountHolderVerification	true	Account holder verification details.
verifications.accountHolderVerification.id	true	Unique verification ID.
verifications.accountHolderVerification.result	true	The outcome of the Account Holder Verification (AHV) process. Possible values: `MATCH`, `CLOSE_MATCH`, `NO_MATCH`, `ERROR`.
verifications.accountHolderVerification.executedAt	true	Timestamp of Account Holder Verification Execution (ISO 8601).
initiatedBy	false	Details about who or what initiated the transaction.
initiatedBy.performer	false	The entity that performed the initiation.
initiatedBy.performer.id	false	Unique UUID of the action's performer.
initiatedBy.performer.type	false	The type of the performer (e.g., `USER`, `API_CLIENT`).
initiatedBy.performer.name	true	Name of the user.
decisions	true	Records of manual approvals or rejections.
decisions[].performer	true	Details of the action's performer.
decisions[].performer.id	true	Unique UUID of the action's performer.
decisions[].performer.name	true	The full name of the performer.
decisions[].performer.type	true	The type of the performer. Possible values: `USER`, `API_CLIENT`.
decisions[].performer.name	false	Name of the user.
decisions[].type	true	Type of performer's decision. Possible values: `APPROVED`, `REJECTED`.
decisions[].subject	true	Subject of the decision. Possible values: `ACCOUNT_HOLDER_VERIFICATION`, `TRANSACTION`.
decisions[].createdAt	true	The timestamp when the decision was initially created (ISO 8601).

Payout example:

{
  "id": "646faf43-3fcc-4263-8552-16fd447ce226",
  "status": "COMPLETED",
  "operation": "OUTGOING",
  "type": "PAYOUT",
  "subtype": "CLOSE_LOOP",
  "createdAt": "2026-01-27T14:01:41.813328Z",
  "updatedAt": "2026-01-27T14:01:44.570295Z",
  "amount": 2,
  "currency": "EUR",
  "paymentReference": "payment-reference",
  "internalReference": "internal-reference",
  "paymentRail": "SEPA_INSTANT",
  "beneficiary": {
    "name": "Jon Doe",
    "email": "jon.doe@example.com",
    "country": "DE",
    "accountIdentifiers": {
      "iban": "PL61109010140000071219812874",
      "swiftBic": "WBKPPLPP"
    },
    "address": {
      "addressLine1": "Line 1",
      "city": "Berlin",
      "postalCode": "00-120",
      "country": "DE"
    }
  },
    "decisions" : [ {
        "performer" : {
          "id" : "96ce9731-7f67-4244-b340-e9eadf7149f6",
          "name" : "Stepanie Gerlach",
          "type" : "USER"
        },
        "type" : "APPROVED",
        "subject" : "ACCOUNT_HOLDER_VERIFICATION",
        "createdAt" : "2026-01-28T13:08:59.239166+01:00"
      } ],
  "sender": {
    "name": "Your account name",
    "customerId": "3ddba750-89e7-45a2-bdc9-99d12018aa34",
    "accountId": "5399e2e9-2693-48a6-bc35-fe4a827d936c",
    "accountIdentifiers": {
      "iban": "DE23874043682755038080"
    }
  },
  "initiatedBy" : {
    "performer" : {
      "id" : "96ce9731-7f67-4244-b340-e9eadf7149f6",
      "type" : "API_CLIENT"
    }
  },
  "verifications": {
    "accountHolderVerification": {
      "id": "1a6ab39c-f258-43a3-b654-65413453eee2",
      "result": "MATCH",
      "executedAt": "2026-01-27T14:01:43.051735Z"
    }
  },
  "_links": {
    "self": {
      "href": "/transactions/646faf43-3fcc-4263-8552-16fd447ce226",
      "method": "GET"
    },
    "accountHolderVerification": {
      "href": "/account-holder-verifications/1a6ab39c-f258-43a3-b654-65413453eee2",
      "method": "GET"
    }
  }
}

Outgoing Internal example :

{
  "id": "4f4552fd-7a23-46f8-ac81-c756ed04e334",
  "status": "COMPLETED",
  "operation": "OUTGOING",
  "type": "INTERNAL",
  "createdAt": "2026-01-27T14:20:37.921158Z",
  "updatedAt": "2026-01-27T14:20:38.876082Z",
  "amount": 1,
  "currency": "EUR",
  "paymentReference": "test",
  "internalReference": "internal",
  "paymentRail": "INTERNAL",
  "beneficiary": {
    "accountIdentifiers": {
      "iban": "DE16175282381567945827"
    }
  },
  "sender": {
    "name": "Your Account Name",
    "customerId": "3ddba750-89e7-45a2-bdc9-99d12018aa34",
    "accountId": "5399e2e9-2693-48a6-bc35-fe4a827d936c",
    "accountIdentifiers": {
      "iban": "DE23874043682755038080"
    }
  },
  "initiatedBy" : {
    "performer" : {
      "id" : "96ce9731-7f67-4244-b340-e9eadf7149f6",
      "type" : "API_CLIENT"
    }
  },
  "_links": {
    "self": {
      "href": "/transactions/4f4552fd-7a23-46f8-ac81-c756ed04e334",
      "method": "GET"
    }
  }
}

Settlement example:


{
  "id": "2d21840a-1122-46a6-8b7e-edd627d73183",
  "status": "COMPLETED",
  "operation": "OUTGOING",
  "type": "SETTLEMENT",
  "createdAt": "2026-01-27T16:39:08.628197Z",
  "updatedAt": "2026-01-27T16:39:10.495643Z",
  "amount": 76,
  "currency": "EUR",
  "paymentReference": "settlement",
  "internalReference": "internal",
  "paymentRail": "SEPA_INSTANT",
  "beneficiary": {
    "name": "nameee",
    "country": "GB",
    "accountIdentifiers": {
      "iban": "NL37INGB1070230618"
    },
    "address": {
      "addressLine1": "string",
      "addressLine2": "string",
      "city": "City",
      "postalCode": "31-000",
      "country": "GB"
    }
  },
  "sender": {
    "name": "Accounts- test 1",
    "customerId": "3ddba750-89e7-45a2-bdc9-99d12018aa34",
    "accountId": "5399e2e9-2693-48a6-bc35-fe4a827d936c",
    "accountIdentifiers": {
      "iban": "DE23874043682755038080"
    }
  },
  "initiatedBy" : {
    "performer" : {
      "id" : "96ce9731-7f67-4244-b340-e9eadf7149f6",
      "type" : "API_CLIENT"
    }
  },
  "_links": {
    "self": {
      "href": "/transactions/2d21840a-1122-46a6-8b7e-edd627d73183",
      "method": "GET"
    }
  }
}

Rejected payout example :

{
  "id": "3d103802-0402-477c-ba78-bc561a13abb1",
  "status": "REJECTED",
  "failure": {
    "code": "TRANSACTION_REJECTED_BY_BANKING_PROVIDER"
  },
  "operation": "OUTGOING",
  "type": "PAYOUT",
  "subtype": "CLOSE_LOOP",
  "createdAt": "2026-01-27T14:02:42.946598Z",
  "updatedAt": "2026-01-27T14:02:46.54264Z",
  "amount": 2,
  "currency": "EUR",
  "paymentReference": "payment-reference",
  "internalReference": "internal-reference",
  "beneficiary": {
    "name": "fdfdfff",
    "email": "jan.kowalski@example.com",
    "country": "PL",
    "accountIdentifiers": {
      "iban": "PL61109010140000071219812874",
      "swiftBic": "WBKPPLPP"
    },
   "address": {
      "addressLine1": "Line 1",
      "city": "Berlin",
      "postalCode": "00-120",
      "country": "DE"
    }
  },
  "sender": {
    "name": "Your account name",
    "customerId": "3ddba750-89e7-45a2-bdc9-99d12018aa34",
    "accountId": "5399e2e9-2693-48a6-bc35-fe4a827d936c",
    "accountIdentifiers": {
      "iban": "DE23874043682755038080"
    }
  },
  "initiatedBy" : {
    "performer" : {
      "id" : "96ce9731-7f67-4244-b340-e9eadf7149f6",
      "type" : "API_CLIENT"
    }
  },
    "decisions" : [ {
        "performer" : {
          "id" : "196d1d75-5971-4db4-9f80-897e3fb8601d",
          "type" : "API_CLIENT"
        },
        "type" : "APPROVED",
        "subject" : "ACCOUNT_HOLDER_VERIFICATION",
        "createdAt" : "2026-01-28T13:06:55.591129+01:00"
      } ],
  "verifications": {
    "accountHolderVerification": {
      "id": "35aad002-7265-41ac-a5ab-c9231524034a",
      "result": "MATCH",
      "executedAt": "2026-01-27T14:02:44.100315Z"
    }
  },
  "_links": {
    "self": {
      "href": "/transactions/3d103802-0402-477c-ba78-bc561a13abb1",
      "method": "GET"
    },
    "accountHolderVerification": {
      "href": "/account-holder-verifications/35aad002-7265-41ac-a5ab-c9231524034a",
      "method": "GET"
    }
  }
}

Account Holder Verification Result Completed

Field	Nullable	Description
id	false	Id of Account Holder Verification Process.
transactionId	false	Id of Transaction.
status	false	Status of Account Holder Verification Process. Possible values: `COMPLETED`, `PROCESSING`, `FAILED`.
accountHolderName	false	Group of names for verification.
accountHolderName.requested	false	The name provided by the merchant for verification.
accountHolderName.returned	true	The actual name retrieved from the bank's records.
result	false	Verification result. Possible values: `MATCH`, `CLOSE_MATCH`, `NO_MATCH`, `ERROR`.
executedAt	false	Timestamp of Account Holder Verification Execution (ISO 8601).

Account Holder Verification Result Completed Example


{
  "id": "770b259e-fbcf-4cf5-b0af-ffc902761b65",
  "transactionId": "50aa6568-91f4-4969-9143-5778b500e7dd",
  "status": "COMPLETED",
  "accountHolderName": {
    "requested": "Jon Doe",
    "returned": "Jon Doe"
  },
  "result": "CLOSE_MATCH",
  "executedAt": "2026-01-27T14:28:26.490808Z",
  "_links": {
    "self": {
      "href": "/account-holder-verifications/770b259e-fbcf-4cf5-b0af-ffc902761b65",
      "method": "GET"
    },
    "transaction": {
      "href": "/transactions/50aa6568-91f4-4969-9143-5778b500e7dd",
      "method": "GET"
    }
  }
}

Payments notifications