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": {
    "notifications": {
      "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

Prop

Type

{
  "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": "https://accounts.sandbox.volt.io/transactions/f291b32a-1252-494f-ae5b-f487983d9f22",
      "method": "GET"
    }
  }
}

Outgoing transactions

Prop

Type

{
  "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": "https://accounts.sandbox.volt.io/transactions/646faf43-3fcc-4263-8552-16fd447ce226",
      "method": "GET"
    },
    "accountHolderVerification": {
      "href": "https://accounts.sandbox.volt.io/account-holder-verifications/1a6ab39c-f258-43a3-b654-65413453eee2",
      "method": "GET"
    }
  }
}

Account Holder Verification Result Completed

Prop

Type

{
  "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": "https://accounts.sandbox.volt.io/account-holder-verifications/770b259e-fbcf-4cf5-b0af-ffc902761b65",
      "method": "GET"
    },
    "transaction": {
      "href": "https://accounts.sandbox.volt.io/transactions/50aa6568-91f4-4969-9143-5778b500e7dd",
      "method": "GET"
    }
  }
}

Payments notifications

Types of notifications

Configuration and overrides

Get transaction details

Incoming transactions

Outgoing transactions

Account Holder Verification Result Completed

On this page