Documentation Index
Fetch the complete documentation index at: https://docs.dualentry.com/llms.txt
Use this file to discover all available pages before exploring further.
How to Connect Bank Accounts
Connect your bank accounts to DualEntry to pull in transaction feeds automatically. Each connection links a bank account to a GL cash or liability account so incoming transactions land in the right place for reconciliation. DualEntry supports checking accounts, savings accounts, credit cards, and lines of credit, with no per-organization limit on the number of connections you can add.
Prerequisites
Before connecting, confirm the following:
- You have admin or bookkeeper-level access in DualEntry (see User Roles and Permissions).
- The GL cash or liability account the bank will map to already exists in your chart of accounts.
- You have online banking credentials for the institution you want to connect.
Connect via a certified aggregator
DualEntry connects to your bank through a certified third-party aggregator. The aggregator handles authentication with your bank and returns a secure access token to DualEntry - you never paste banking credentials into the DualEntry interface.
To connect a bank account:
- Navigate to Company → Bank Connections in the DualEntry sidebar.
- Click Add Bank Connection. DualEntry opens the aggregator’s hosted flow in a new window.
- Search for your bank, then sign in with your online banking credentials.
- Select the accounts you want to connect. You can connect multiple accounts from the same institution in a single flow.
- After approval, the aggregator redirects back to DualEntry. Each selected account appears in the Bank Connections list with a status of Connected.
Some institutions require multi-factor authentication during the hosted flow. If your bank requires MFA, you complete it inside the aggregator’s window - DualEntry never sees the MFA code.
The aggregator’s coverage determines whether your bank is supported. If you cannot find your institution in the search step, your bank is not currently supported by the aggregator and you should use the manual upload path instead. For details on the three connection paths and how DualEntry handles aggregator-side outages, see Banking Connections: Paths, Sync, and Security.
Connect via manual upload
If your bank is not supported by the aggregator, or you prefer to upload statements manually, use CSV or BAI import instead. Manual upload connections rely on you to provide transaction data on a regular cadence - DualEntry does not poll the bank itself.
To set up a manual upload connection:
- Navigate to Company → Bank Connections and click Add Bank Connection.
- Choose Manual Upload.
- Name the connection and select the GL account it maps to.
- Upload a CSV or BAI file. DualEntry parses the file and shows a preview of the transactions it found.
- Confirm the column mapping (date, description, amount) and save.
Manual upload connections don’t refresh automatically. You upload a new file each time you want to bring in recent activity - at minimum, monthly by the 5th business day of the following month if you want reconciliation to stay current. Once uploaded, transactions land on the same financial account record as aggregator-sourced transactions, so reconciliation, rules, and bank match behave identically downstream regardless of how the data arrived.
GL mapping and feed frequency
Every bank connection must be mapped to exactly one GL account. This mapping determines where transactions appear in your ledger and which account is reconciled during bank reconciliation.
To configure or change the mapping:
- Open Company → Bank Connections.
- Select the connection you want to configure.
- Under GL Account, choose the cash or liability account from the dropdown.
- Save.
If you change the GL mapping after transactions have already been imported, existing transactions keep their original GL account. Only new transactions use the updated mapping.
Aggregator-backed connections refresh automatically. DualEntry pulls new transactions at the cadence supported by the aggregator, typically daily. You can also trigger a manual refresh from the Bank Connections screen by selecting Refresh Now on any connection - DualEntry enforces a one-hour cooldown between manual refreshes per connection to limit aggregator throttling. Feed latency depends on the institution. Most banks make transactions available within one business day, but some post with a two-day delay. Pending transactions (authorizations not yet settled) are excluded from the feed to avoid matching against amounts that may change.
Manage, disconnect, and reconnect
The Bank Connections list shows the status, last sync time, and GL account for every active connection. To keep things organized, name each connection with the institution and last four digits of the account number (for example, “Chase ••1234”). DualEntry doesn’t enforce a naming convention, but a consistent pattern makes it easier to identify connections at a glance.
To disconnect a bank connection:
- Open Company → Bank Connections.
- Select the connection and choose Disconnect.
- Confirm the action.
Disconnecting stops future syncs but does not remove previously imported transactions or reconciliation history. The connection becomes inactive in the list, and any GL accounts it mapped to are unlinked from the disconnected feed but otherwise unchanged. To reconnect the same account, start a new connection through Add Bank Connection - DualEntry creates a fresh connection rather than reactivating the old one. You will need to re-map the new connection’s accounts to the same GL accounts to keep the reconciliation history continuous.
If a connection enters an error state (typically because the bank revoked the token or your credentials changed), DualEntry flags it as Needs Attention. Reconnect by selecting Reconnect on the affected connection and completing the aggregator’s hosted flow again - this preserves the existing connection record and its GL mappings.
After connecting
After completing these steps, your bank transactions flow into DualEntry and are ready for matching and reconciliation. The first sync begins immediately and typically completes within a few minutes for an aggregator-backed connection; transactions then continue to flow on the aggregator’s regular cadence with no further action required.
The Bank Connections screen serves as your central dashboard for monitoring sync status, troubleshooting feed issues, and managing GL mappings across all connected accounts. If a connection stops syncing or enters an error state, the dashboard surfaces the issue immediately so you can reconnect before it affects your reconciliation workflow. You can also use the dashboard to verify that each connection’s GL mapping is correct and that sync timestamps are current.
As your organization grows, you can add new connections at any time without disrupting existing ones. Each new connection begins syncing independently and populates its own staging area for reconciliation. For the next step in the workflow, see How to Reconcile Bank Accounts to match imported transactions against your ledger. For details on how DualEntry’s AI accelerates the matching process, see Bank Match AI.