Lifecycle
An account is created together with its customer and waits for the customer’s verification before provisioning starts. The lifecycle has these statuses:
The happy path is
AWAITING_ONBOARDING → REQUESTED → PROVISIONING → ACTIVE. Provisioning can pause in RFI when more information is needed, and can end in REJECTED. An account moves to INACTIVE when it’s closed or when its customer becomes inactive.
If an account moves to
RFI, you’ll be notified of the specific information needed. Provide the requested details to continue verification.Subscribe to webhooks for real-time notifications when an account’s status changes.
Activation timelines
The time an account takes to move fromREQUESTED to ACTIVE once the customer is approved varies by currency, because Lumx has direct reliance with local banking partners in some markets but not others.
Subscribe to the
account.active webhook to know the moment an account is ready to receive funds.
Related resources
Customers
The legal entity that owns the account.
Transactions
Move funds in and out of accounts.
Destinations
External payout targets for outbound fiat.
Coverage
Supported rails and currencies by country.