Open an account

Use this flow to open an account for an active BaaS client. The account is opened in the create request; bank details are provisioned asynchronously.

Before you start

You need:

a valid access token;

a Framnex client identifier;

a stable account identifier from your own system;

the account currency.

The client must already be Active. If you have not created the client yet, complete Onboard a client first.

1. Create the account

The BaaS API accepts your own stable account identifier together with the Framnex client identifier and currency.

Example:

See the generated API reference for the current request and response schema:

Open the create account endpoint

2. Store the Framnex account identifier

A successful response contains the Framnex account identifier. Keep it together with your own externalId and client mapping.

3. Handle bank-detail provisioning

The account is opened in the create-account request. Bank details are provisioned asynchronously and may not be available immediately after the account is created.

You can retrieve the account when you need its current data:

Open the get account endpoint

Do not treat temporarily unavailable bank details as a failed account creation.

4. Continue with money movement

After the create-account request succeeds, keep the account identifier for the next supported exchange-rate and transfer flows. If a specific flow depends on bank details, wait until those details are available. Before production transfers, configure webhooks so your system can process asynchronous state changes.

Continue with Create an outgoing transfer and Handle webhooks in the Guides folder.

Before you start#

1. Create the account#

2. Store the Framnex account identifier#

3. Handle bank-detail provisioning#

4. Continue with money movement#

Before you start

1. Create the account

2. Store the Framnex account identifier

3. Handle bank-detail provisioning

4. Continue with money movement