Empower your customers with robust digital banking accounts using our comprehensive Accounts API. This section facilitates the entire lifecycle of a savings account—from initial submission and product association to rigorous institutional approval and final activation.

Built to support flexible interest structures, overdraft capabilities, and dynamic fee configurations, these accounts form the bedrock of a scalable financial ecosystem.

Standard Onboarding Workflow

Successful account creation follows a mandatory three-stage institutional lifecycle:

1. Stage 1: Submission: Call this API with the command=submit parameter to link a client to a specific product blueprint. The account is created in a Submitted and Pending Approval state.
2. Stage 2: Institutional Approval: The submitted account must be reviewed and authorized (typically by an institutional officer). This transitions the account to Approved status.
3. Stage 3: Activation: Finalize the process by activating the account. It is only at this stage that the account is assigned its final account number and becomes eligible for financial transactions.

Operational Prerequisites

To ensure a successful account opening, verify the following:

• Active Client Profile: Accounts can only be opened for clients who have completed KYC and are in Active status.
• Product Blueprint: You must reference a valid productId representing a pre-configured savings product that governs interest rates, lock-in periods, and operational limits.

Professional Best Practices

• Automated Fee Collection: Utilize the charges array during the submission stage to automate the application of account opening fees or initial service charges.
• External Synchronization: Use the externalId field to map these accounts back to your internal CRM or legacy systems for real-time data consistency.
• Monitoring: Leverage webhooks to track movement through the lifecycle and trigger downstream events (e.g., sending a "Welcome" email upon account activation).

Document References

• Account Features Introduction
• Advanced Charge Behavior Guide
• Account Webhook Specifications