Understanding Accounting on Swipey

Before you connect your accounting software to Swipey, it helps to understand what's actually happening under the hood. This article covers the core concepts, so when you go through the setup wizard, nothing feels like a mystery.

💡
New to accounting integration? Read this first.

The setup wizard (powered by Alfie, our AI assistant) will guide you through connecting your account but this article helps you understand why you're doing each step.

1
Your accounting system is a money diary
The core concept

Every time money moves whether you're depositing funds into Swipey, topping up a card, or making a payment your accounting system needs to know about it. Money doesn't appear out of thin air; it always moves from one account to another.

This is why every transaction has two sides:

Column
What it means
Example
From Account
Where money is leaving
Your Maybank company account
To Account
Where money is going
Your Swipey Master account

Both sides must always balance. This is true for every transaction in Swipey: deposits, card spends, top-ups, and clawbacks.

2
Why you need to create Swipey accounts in your accounting software
Chart of Accounts explained

Your accounting software (QuickBooks, Xero, or Bukku) comes with a predefined list of accounts called a Chart of Accounts. This includes things like Sales, Cost of Goods Sold, and your bank accounts.

However, your accounting software has no idea that Swipey exists. So when you move money into Swipey, you need to tell your system where that money went, which means creating a Swipey entry inside your Chart of Accounts.

💸 Example: depositing RM5,000 into Swipey

From
🏦 Maybank (Company)
RM5,000
To
💼 Swipey Master
From
💼 Swipey Master
RM500
To
💳 Swipey Cards
From
💳 Swipey Cards
RM120
To
🖥️ Software (Expense)
Good news! Alfie handles this for you

When you connect your accounting software to Swipey, our AI assistant (Alfie) will either find your existing Swipey accounts or help you create new ones. You won't need to manually navigate your Chart of Accounts.

3
Two accounts vs one account. Which is right for you?
Choose your setup style

During setup, Alfie will ask whether you want to track Swipey with two separate accounts (Master + Cards) or a single general Swipey account. Here's what each means:

🗂️

Two accounts: Master + Cards

Track funds separately between your Swipey Master (the wallet) and Swipey Cards (employee spend). Gives you full visibility into internal movements like top-ups and clawbacks.

Most common

📁

One general Swipey account

Treat all Swipey money as one bucket. Internal movements (top-ups between Master and Cards) won't be synced — only deposits and card expenses. Good if internal tracking isn't a priority.

🤔 Not sure which to pick?

If you want to...
Use this setup
Track when money moves from Master to a card (top-ups)
Two accounts (Master + Cards)
See spend per employee with separate card accounts
Two accounts (you can create one per cardholder)
Only track deposits and expenses — internal movement doesn't matter
One general Swipey account
4
Expenses vs Internal Transfers — what's the difference?
The two sync tabs explained

Once connected, the accounting page in Swipey is split into two tabs. Here's what each one covers:

Tab
What's included
Example
Expenses
Card transactions & bill payments
Staff paid for Microsoft 365 with a Swipey card → syncs as a "Software" expense
Internal Transfers
Deposits, card top-ups, clawbacks
You deposited RM10,000 from Maybank → syncs as From: Maybank, To: Swipey Master

For Expenses, Swipey pre-fills the From Account (your Swipey Cards account) automatically. You only need to select the To Account — the expense category, e.g. Software, Travel, Equipment.

For Internal Transfers, both accounts are pre-filled based on your setup. A deposit will show automatically as: From → your bank, To → Swipey Master.

5
What to expect during setup
A quick overview of the Alfie flow

When you connect for the first time, Alfie guides you through a short setup flow. Here's what happens at each step:

1
Connect your accounting software

For QuickBooks, a login pop-up appears, sign in and select your company. Learn how to set up here.
For Xero, a login pop-up appears, sign in and select your company. Learn how to set up here.
For Bukku, you'll generate an API key from your Bukku account and paste it into Swipey. Learn how to set up here.

2
Alfie scans your Chart of Accounts

Alfie reads all your existing accounts and looks for anything that looks like a Swipey account. This takes a moment, you'll see a "Connecting, please check back later" message.

3
Choose your path: Check existing or Start from scratch

Check my existing accounts: if you've been tracking Swipey manually, Alfie will suggest the best match. You can accept it or choose a different account from the dropdown.

Start from scratch: Alfie creates the Swipey accounts inside your accounting software for you automatically.

4
Link your Master and Cards accounts

Alfie walks you through linking both accounts (or one, if you chose single-account setup). Once done, you'll see a green "Linked" label and you're ready to start syncing.

⚠️
Don't disconnect after setup

Once your accounting software is connected, avoid disconnecting it. This may cause your sync settings to be lost. If you run into issues, reach out to the Swipey support team before disconnecting.


Was this article helpful?