Setting Up Bank Feeds

Step-by-step guide to connecting your bank account for automatic transaction imports.

Overview

Bank feeds automatically import transactions from your bank into Beeswax, saving you from manually entering or uploading CSV statements. Once connected, transactions flow in automatically and appear in the Bank Feed Allocations queue for categorization.

Beeswax supports multiple bank feed providers. The provider available to you depends on your region and your account configuration. You may have one or more providers enabled, and different bank accounts can use different providers.

Provider Regions Connection Type Description
Revolut Business UK, EU, US API Token (manual) Direct connection to your Revolut Business account via their API
Basiq Australia OAuth (automatic) Connects to Australian banks via the Basiq aggregation service

Note: Additional providers may be added over time. If you need a provider that is not listed, contact support.

Before You Start

Before connecting a bank feed, make sure you have:

  1. A bank account set up in Beeswax — You need an Asset-type transaction account marked as a bank account. Create one from the Chart of Accounts if you haven't already.
  2. The correct permissions — Only Owners, Super Admins, and Accountants can connect bank feeds.
  3. Access to your banking provider — You will need to log in to your bank to generate credentials or authorise the connection.

Connecting Revolut Business

Revolut Business uses a personal API token to connect. The token gives Beeswax read-only access to your account transactions.

Step 1 — Generate an API Token in Revolut

  1. Log in to your Revolut Business account at business.revolut.com
  2. Go to Settings (gear icon in the sidebar)
  3. Click API under the Integrations section
  4. Click API Certificates (you may need to navigate to the API settings area first)
  5. Click Generate new token or Add new API certificate
  6. When setting permissions, select read-only access. Beeswax only needs to read transactions — it does not create payments or modify your account.
  7. Complete any verification steps Revolut requires (e.g. approving from the mobile app)
  8. Copy the generated API token. You will only see it once, so paste it somewhere safe until you complete the next step.

Important: Use a token with read-only permissions. Beeswax never writes to your Revolut account, and a read-only token limits exposure if the token were ever compromised.

Step 2 — Connect in Beeswax

  1. Navigate to Banking in the main menu
  2. Find the bank account card you want to connect and click on it
  3. Click Connect Bank Feed (or go to the bank account's settings)
  4. Select Revolut Business if multiple providers are shown
  5. Paste your API token into the token field
  6. Click Connect

Beeswax will verify the token by making a test request to Revolut. If successful, your bank feed status will show as Connected.

Step 3 — Fetch Your Transactions

After connecting:

  1. Click Fetch Transactions to trigger the first sync
  2. Beeswax will import up to 90 days of completed transactions
  3. Transactions appear in the Bank Feed Allocations page, ready for categorization

Subsequent syncs are automatic and will pick up new transactions since the last fetch, with a small overlap to catch any that arrived late.

Revolut Token Notes

  • Revolut Business API tokens do not expire, so you won't need to reconnect periodically
  • If you regenerate your token in Revolut, you will need to disconnect and reconnect in Beeswax with the new token
  • Only completed transactions are imported — pending transactions are excluded until they clear

Connecting via Basiq (Australian Banks)

Basiq is a bank aggregation service that supports most Australian banks. The connection uses a secure OAuth flow — you authorise access through your bank's own login page.

Step 1 — Start the Connection

  1. Navigate to Banking and select your bank account
  2. Click Connect Bank Feed
  3. Select Basiq if multiple providers are shown
  4. Click Connect Securely

Step 2 — Authorise in Your Bank

  1. You will be redirected to the Basiq consent screen
  2. Select your bank from the list
  3. Log in with your bank credentials on your bank's secure page
  4. Approve the data-sharing consent
  5. You will be redirected back to Beeswax

Step 3 — Wait for Sync

After authorising, Basiq needs a short time to fetch your transaction data from your bank. Beeswax will poll for the data — this typically takes 10 to 30 seconds but can occasionally take longer.

Once the sync completes, your transactions will appear in the Bank Feed Allocations page.

Basiq Notes

  • Basiq tokens expire periodically. If your connection shows an error status, you may need to re-authorise
  • The initial sync imports up to 90 days of transactions
  • Some banks may require you to re-authorise every 90 days as part of their open banking requirements

After Connecting

Once your bank feed is connected:

  • Automatic imports — New transactions are fetched automatically in the background
  • Manual refresh — Click Refresh Transactions on the bank feed status page to trigger an immediate sync
  • Allocations — Imported transactions appear in the Bank Feed Allocations page. From there you can match them to existing invoices and expenses, categorize them with AI assistance, or process them manually. See the Bank Feed Allocations help page for details.
  • Duplicate protection — Beeswax tracks each transaction's unique ID from the bank, so the same transaction will not be imported twice even if sync periods overlap
  • Balance updates — Your bank account balance in Beeswax is updated with the balance reported by the bank feed provider

Multiple Bank Accounts and Providers

You can connect bank feeds to multiple bank accounts, and different accounts can use different providers. For example:

  • Your Australian business account could use Basiq
  • Your Revolut Business account could use Revolut Business

Each connection is independent — connecting or disconnecting one account does not affect others.

Disconnecting a Bank Feed

To disconnect a bank feed:

  1. Navigate to the bank account's feed status page
  2. Click Disconnect
  3. Confirm the disconnection

Disconnecting removes the stored credentials but does not delete any previously imported transactions or allocations. You can reconnect at any time.

Troubleshooting

Issue Solution
"No bank feed providers are currently configured" Your Beeswax instance does not have any providers enabled. Contact your administrator to enable a provider.
Connection shows "Error" status The stored credentials may be invalid. Try disconnecting and reconnecting with fresh credentials.
Transactions not appearing after connect Click Fetch Transactions or Refresh Transactions to trigger a manual sync. The first sync can take a moment to complete.
Revolut token rejected Ensure you are using a Revolut Business account (not personal). Double-check the token was copied in full.
Basiq authorisation fails Your bank may be temporarily unavailable on the Basiq network. Try again later, or check Basiq's status page.
Duplicate transactions Beeswax de-duplicates by external transaction ID. If you see duplicates, they may have different IDs from the bank (e.g. amended transactions). Contact support.

Permissions

Action Owner Super Admin Admin Accountant General Client
Connect bank feed Yes Yes No Yes No No
Disconnect bank feed Yes Yes No Yes No No
Refresh transactions Yes Yes No Yes No No
View feed status Yes Yes No Yes No No