ACCOUNT_BALANCE_UPDATE - Orenda Management API

Sent when an account’s settled balance changes. Carries the full account object — the same shape as ACCOUNT_STATUS_UPDATE, with the updated balances.settled. All deliveries share the common envelope (eventId, eventName, timestamp, programId, sandbox, customerId, clientReference).

`account` fields

The currency determines the rail identifiers: EUR carries iban/bic, GBP carries accountNumber/sortCode, and MULTI carries neither.

Field	Type	Notes
`accountId`	string	The account identifier.
`currency`	string	`EUR`, `GBP`, or `MULTI`.
`iban` / `bic`	string	EUR accounts only.
`accountNumber` / `sortCode`	string	GBP accounts only.
`status`	string	`PENDING`, `ACTIVE`, `BLOCKED`, or `CLOSED`.
`balances.settled`	number	Updated settled balance, minor units.

Example

{
  "eventId": "a7e4…",
  "eventName": "ACCOUNT_BALANCE_UPDATE",
  "timestamp": "2026-06-23T12:34:56.789Z",
  "programId": "yourprogram",
  "sandbox": false,
  "customerId": "cust_123",
  "account": {
    "accountId": "acc_456",
    "currency": "EUR",
    "iban": "NL31CLRB0024757476",
    "bic": "CLRBNL2A029",
    "status": "ACTIVE",
    "balances": { "settled": 10000 }
  }
}