Banking & Reconciliation
Manage bank accounts, Plaid-connected bank activity, and reconciliation.
Bank Accounts
Create bank accounts linked to your chart of accounts. Each account owns its own bank transactions and reconciliation workflow.
Fields
| Field | Description |
|---|---|
| Account Name | Display name (e.g., "Business Checking") |
| Account Number | Masked number for display |
| Bank Name | Name of the bank |
| Currency | Account currency |
| Country | Country or region of the account |
| Account Type | Checking, savings, credit card, cash, loan, investment, or other |
| Accent Color | Visual identity used across the banking UI |
| GL Account | Chart of accounts link |
Bank Activity
Bank and card activity arrives through Plaid-connected feeds, which sync internally on a webhook-driven basis. There is no public "import rows" endpoint. Partner posting endpoints also create bank-register rows automatically when a purchase, deposit, transfer, or bill payment uses a bank-linked chart account.
Synced rows enter as bank transactions with sourceType: plaid_bank_feed and
store provenance including the external transaction ID, sync batch, and raw
payload metadata.
The supported flow is:
- Connect a bank or card through Plaid and map it to a bank account
- Let Plaid-connected feeds sync activity automatically
- Review unreconciled transactions
- Categorize or reclassify account/contact/tax fields
- Post, match, split, reconcile, or exclude transactions
- Pull financial packet JSON for report rendering
Relevant routes:
| Method | Path | Purpose |
|---|---|---|
GET | /api/v1/bank-feeds | List connected bank feeds |
GET | /api/v1/bank-feeds/health | Per-connection and per-account Plaid feed health |
POST | /api/v1/purchases | Post spend activity and create bank-register activity when bank-linked |
POST | /api/v1/deposits | Post received money and create bank-register activity when bank-linked |
POST | /api/v1/transfers | Post movement between two balance-sheet accounts |
POST | /api/v1/bill-payments | Post a bill payment from a bank-linked or other balance-sheet account |
Reconciliation
Reconciliation matches bank transactions to your accounting records.
Transaction Statuses
- Unreconciled — Not yet matched
- Reconciled — Matched to a journal entry
- Excluded — Intentionally ignored (e.g., transfers between own accounts)
Reconciliation Workflow
- Navigate to the bank account → Reconcile
- Create a new reconciliation session with date range
- Review unreconciled transactions
- Match each transaction to invoices, bills, journal entries, or approved classifications
- Mark as reconciled or excluded
The fuzzy matcher suggests matches based on amount, date, reference, and description.