Once a customer account is created, it lives through different states depending on the actions taken by your team, your users, or automated workflows.
What Is the Account Lifecycle?
Every account in XYB has a status. This reflects whether the account is active, blocked, or closed.
The account status impacts:
Whether money can be sent or received
Whether wallets remain open or suspended
What is shown in dashboards or statements
States in the Lifecycle
Initial state during creation. Not active yet.
Account is active and can transact.
Account cannot receive funds.
Account cannot send funds.
Account cannot send or receive.
Temporarily closed. Can be reopened if policy allows.
Permanently closed. Cannot be reopened.
How to Change an Account's State
Request Payload
Returns AccountStateChange object with:
Four-Eye Approval Workflow
For sensitive state transitions (e.g. closing an account), you can enable Four-Eye Policies:
Wait for approval (second actor)
Auto-apply if approved, or discard if rejected
This happens automatically if your product or policy config requires it.
Use Case Examples
Suspend an Account
Reopen an Account
Close an Account Permanently
State Sync with Wallets & Ledger
Wallets are automatically synced with account state.
Ledger behavior (e.g., status update) is handled via strategy-specific logic.
All state transitions are recorded and available for audit.
Events You Can Listen To
XYB emits Kafka events such as:
These can be used to trigger:
UI / MFE Integration
In the XYB micro-frontend or your custom UI, you can:
Show current account state
Display full state history
Trigger lifecycle changes via dropdowns/forms
Last updated
