Accounts

In Falcon, an Account is the central financial identity used to manage credit, transactions, repayments, and operational controls for cardholders, whether individuals, businesses, or aggregator-led users.

An account acts as:

A store of value, managing available balance, and credit limits
A hub linking multiple cards, payment channels, and transactions
A record of user actions, repayment schedules, and product usage

Accounts can be for:

Retail users (primary or add-on cards)
Corporate users (multiple cards across employees)
Aggregator models (many users/accounts managed by a platform)

🧭 Key Account Concepts

The table below describes the key concepts related to accounts

Concept	Role
Primary vs Secondary Accounts	Primary accounts hold all the financial responsibility. Secondary accounts may have limited linked cards or limits.
Linked Cards	One account can have multiple cards (corporate structures, family add-ons, aggregator users).
Credit Limits	Limits are set and managed per account, with overrides possible at the card level if configured.
Balances	Reflects the real-time available amount or credit after usage and repayments.
Funding Sources	For prepaid or secured models, external bank accounts or FDs can fund balances.
Channels	UPI, POS, online, and ATM access are linked through account set up and configurations.

🔁 Account Lifecycle

The following table describes an account lifecycle.

Stage	Description
Account Creation	Created after completing the necessary onboarding procedure
Activation	Enable financial activity once approved
Ongoing Management	Manage balances, limits, transactions, and settings
Block	Temporary block based on business rules or risk triggers
Closure	Final settlement and closing of an account

⚙️ Account Actions

The table below describes various account actions.

Action	Purpose
Create Account	Onboard a user or an entity with initial limits and configurations
Fetch Account	Retrieve real-time account status, balances, and linked cards
Update Account	Modify details such as contact info, credit limits, block/unblock access, and so on
Block Account	Block the account temporarily.
Close Account	Terminate the account after final balance reconciliation

↑