API ReferenceEvent Referenceaccounting.balance.changed.v1

accounting.balance.changed.v1

Constant

import { EVENT_NAMES } from "@platform/contracts";
 
EVENT_NAMES.ACCOUNTING_BALANCE_CHANGED_V1;

Publishers

Subscribers

No service currently subscribes to this event.

Payload schema

z.object({
  account_id: z.string(),
  party_type: z.string().nullable(),
  party_id: z.string().nullable(),
  previous_balance_cents: z.number().int(),
  new_balance_cents: z.number().int(),
  transaction_id: z.string(),
  changed_at: z.string().datetime(),
}

Delivery semantics

  • At-least-once delivery. Consumers must dedupe by event ID.
  • Fanned out to both NATS (in-cluster) and EventBridge (durable). See Events concept.