Skip to content
FinanlySupport

Add a bank or card account

4 min readAdministrators

Use this workflow to add a bank or card account in a business workspace with the correct bank, account number, and current ledger account. If a save is already in progress, recover the original request instead of creating a duplicate, and do not treat a missing balance as zero.

Before you start

  • You are signed in as the current business owner or admin.
  • Your workspace is a business workspace, not a personal workspace.
  • Your workspace must be entitled to txn_review and connector_erpnext.
  • The connected ledger has bank account saves enabled.
  • You have an existing bank name, account number, and current ledger account selected for the save.
  • If you are resuming a previous save, keep the original request key and the existing command or confirmation shown in the app.

Add a new bank or card account

Use this when you are creating a new bank or card account that has not already been saved in Finanly. Choose the existing bank, pick the current ledger account, and submit only the original request you started.

  1. Open the bank account setup area in your business workspace.
  2. If the app shows Enable bank account saves, select it first and wait for setup to be confirmed before you continue.Enable bank account saves
  3. In Account label, enter the name you want to use for the account.Account label
  4. In Bank, choose or enter the bank name.
  5. In Account number, enter the account number for the bank or card account.Account number
  6. In Ledger account, select the current ledger account that should be linked to this bank account.Ledger account
  7. If needed, choose Account type (optional). Leave it blank if you do not need a type.Account type (optional)
  8. Select Create bank account.Create bank account

Expected result: the account is recorded, and the app may show confirmation with a queued refresh, or it may remain pending until verification completes.

Recover or continue an existing save

Use this when the account was already started and the app shows an original request, a saved command, or a pending confirmation. Recover checks the existing save; Continue original save retries the same reviewed save when the app allows it.

  1. Open the original request area in the setup panel.
  2. Select Check original request to reload the saved request and review its current status.Check original request
  3. If the request was rejected before creation, select Edit rejected request and update the form instead of starting a new duplicate save.Edit rejected request
  4. If the request is still pending and the app offers it, select Check save to review the stored command.Check save
  5. If the app offers Continue original save, use it only for the same original request and keep the same request key.Continue original save

Expected result: the app shows the current status of the same save, and if verification succeeds it confirms the account.

Cancel an unsent request

Use this only when the request has not been sent yet and the app clearly shows the original unsent request. This cancels the stored request and lets you review the form before starting again.

  1. Open the original request in the setup panel.
  2. Make sure the request is still unsent and not already confirmed.
  3. Select Cancel unsent request.Cancel unsent request
  4. Review the form again before you create a new save.

Expected result: the app marks the unsent request as cancelled and clears it from the current setup flow.

What the fields mean

Bank account setup fields
FieldWhat to enter
Account labelThe label you want users to see for this bank or card account.
BankThe bank or card institution name.
Account numberThe account number for the bank or card account.
Ledger accountThe current ledger account that should be linked to this bank account.
Account type (optional)Leave blank unless you need to classify the account type.

The selected ledger account determines the currency used for the save. Use the current ledger account carefully, because a mismatched ledger or currency can prevent the save from being verified.

For balances, treat a missing or unavailable amount as unknown, not zero. A verified balance and a zero balance are different, and the app may show unavailable or pending when it cannot confirm a current snapshot.

When something goes wrong

  • If you see a message asking you to enable bank account saves, the connected ledger still needs that setup before you can create a new account.
  • If the app says the request is pending or unconfirmed, open the original request and recover that same save instead of starting over.
  • If the app says the request was rejected before creation, use Edit rejected request and correct the form fields.
  • If the app says the workspace is not supported, you are likely in a personal workspace or do not have the required business access.
  • If a balance is missing after saving, refresh the existing account or check the original request rather than assuming the balance is zero.

Updated

Related guides

Understand bank balances and freshness

Bank balances can come from a provider snapshot, a cached provider balance, or a ledger-based balance, and those values are not the same thing. This article explains how to read the balance fields, what freshness means, and why a balance may be shown as unavailable, unknown, or zero.

5 min readAll workspacesRefresh or import an existing ledger bank account

Use this flow to refresh an existing bank account from your connected ledger, or to continue, cancel, or review an original refresh request. You can only work with the current company and the same saved request; no new financial replay is started from this screen.

3 min readAdministratorsSet account names and import cutover dates

Manage bank account display names and cutover settings in Settings > Account > Bank accounts. Use nicknames and visibility to control how accounts appear in the UI, and use the suggested cutover anchors to mark where seeded history ends and live activity begins without changing the account’s underlying identity, balances, or transaction history.

3 min readAdministrators
We can help

Still need a hand?

Tell us which workspace and page you were using, what you expected, and what happened. Include the time and any request reference shown on screen.

Keep passwords, access tokens and private bank details out of your message. Review screenshots before sharing them.

Contact supportSend a request to our team.A simple form, with a reference for follow-up.Check system statusSee current service availability and monitoring history.Individual connection health is shown in your workspace.