Kafka Topics Quick Reference Guide

Kafka topics enable event-driven communication across the XYB platform. Subscribe to these to receive real-time updates about account creation, balance changes, and lifecycle transitions.

Informational Topics (Produced by XYB Accounts)

Topic Name	Event Type	Purpose
info.cac.account.account.v1	Info Broadcast	Emits full account payload when an account is created or updated.
info.cac.account.balance-update.v1	Info Broadcast	Notifies downstream services of wallet balance updates.
info.cac.account.create-result.v1	Operation Result	Response after an account creation command is processed.
info.cac.account.status-change.v1	Lifecycle Event	Signals a change in account status (e.g., Open → Suspended).
info.cac.account.status-result.v1	Operation Result	Acknowledgement or result from a status change command.

---

Operational Topics (Listen to these to trigger workflows)

Topic Name	Event Type	Use Case
oper.cac.account.create-command.v1	Action Command	Send this message to initiate account creation via event-driven onboarding.
oper.cac.account.status-command.v1	Action Command	Trigger a lifecycle state change (e.g., Suspend an account).

---

Best Practices

• Subscribe to info.cac.account.* topics to keep downstream systems (e.g., CRMs, reporting tools, risk engines) in sync.

• Use oper.* topics only if you’re implementing an async orchestration layer or workflow that doesn’t rely on REST APIs.

• Use create-result and status-result topics to confirm command success and trigger dependent actions.

---