Amazon and Walmart orders
A card charge tells you that Amazon took $47.23. It does not tell you that the $47.23 was printer ink, a birthday present and a bag of coffee — and if you are trying to work out where your money goes, that is the part you wanted.
Syncing a retailer fetches your orders and matches them to the transactions you already have, so the charge can show what was in it.
Where it lives
You read a retailer's orders on the Transactions page, in the Retail sync tab, and on each transaction they matched. Settings → Retail sync lists the retailers you can sync and any you already have orders from; a retailer SageFin cannot sync and you have nothing from is left out, there and in the tabs. Three are supported:
- Amazon — order history, matched down to the line items in an order.
- Walmart — orders matched to transactions.
- Costco — both warehouse receipts and costco.com orders. A warehouse receipt has a barcode rather than an order number, which is why a Costco row sometimes looks unlike the others.
How orders reach SageFin now
From SageFin Desktop, on your own computer. It is SageFin as a desktop app, with one thing a browser tab cannot do: it opens a retailer in its own window, you sign in there yourself, and it saves your orders pages and sends them to SageFin to be read. Your retailer sign-ins stay on your computer; SageFin never holds them. Download SageFin Desktop for Mac, Windows or Linux; its source is public, so you can read what it does before you run it.
- Walmart and Amazon sync from the app. First you set up each one's history yourself (below). After that, Sync now in Settings → Retail sync reads only what is new, then opens the next orders still to read, slowly and one at a time, and after the first one the app repeats it once a day while it is running. Closing its window leaves it running, so the daily sync still happens; quit it from its menu bar or tray icon. If the retailer shows its robot check, the sync stops at once and says so; it does not wait for anyone to answer the check. If the retailer turns the sync away or asks you to sign in, the sync stops and shows you the window. Either way it does not run again by itself until you press Sync now. To reconnect a retailer that signed you out, sign in again in that window, then press Sync now.
- Costco is not in the app yet.
When SageFin Desktop stops being connected. The app sends your orders with a connection made when you signed in to SageFin inside it. That connection ends when that sign-in does — when it reaches its time limit and SageFin asks you to sign in again, or when you sign that computer out from another device — and when you revoke it in Settings → Integrations. The app then stops sending, shows a notification saying it is not connected, and keeps the pages it saves on your computer until it is connected again. Usually you do nothing: when you sign in to SageFin again inside the app, it connects again by itself and sends what was waiting. A connection you revoked yourself stays off while you stay signed in: Settings → Retail sync says the computer is not connected, and Connect this computer connects it again. To keep a computer from sending for good, press Disconnect this computer there instead. An older SageFin Desktop does not say it lost its connection, but signing in again inside it reconnects it the same way.
Setting up your order history
A sync never reaches back through years of orders by itself: Amazon's payments list can only be read from its top, and reading far down it in one go is what makes Amazon ask whether a person is there. So you load your history once, yourself, and the syncs after that only keep up.
- In Settings → Retail sync, inside SageFin Desktop, press Set up history beside Amazon or Walmart. (The app's own Retailers on This Computer window has the same button.) The app opens the retailer's history in its own window: Amazon's Your Payments, or Walmart's Purchase history. Until you finish, Open Amazon (or Open Walmart) opens the same page, so you never have to find it yourself.
- Scroll down Your Payments, or press Next page in Purchase history, as far back as you want. The app saves what you load, exactly as it saves any page you open. It scrolls and presses nothing for you.
- A strip across the top of the window, above the retailer's page, says how far you have got and how far to go: "Setting up your Amazon history · reached March 14, 2025 of January 2, 2025 · 96 orders so far". The first time, it counts down to where your bank history in SageFin starts, because an order older than your first transaction has nothing to match. Once you are there, the strip says That covers all your bank history. If your household is locked in private mode, SageFin cannot read that date, and the strip says so instead of guessing.
- Press Done in the strip. Closing the window once the strip says you are far enough counts as Done too. If you close it sooner, what you loaded is kept, and setting up again carries on from where you stopped.
If the retailer shows its robot check while you are setting up, it is your browsing: answer it in the window and carry on.
Every order you load is on a to-do list. Its charges and total reach SageFin straight away, from the list itself. What is left is each order's own page, with its items: the app keeps a list of those on your computer, and each sync opens the next twenty, newest first. A long history is read over a day or so (see Choosing when a retailer syncs by itself). Each retailer's row in Settings → Retail sync is one line, such as "Up to date · last synced 1 min ago" or "Catching up: 12 orders still to read", with a button only when something needs doing. Press Details under it for the rest: what was sent and what SageFin read, the last sync's result, when the next one is due, how far back the history is set up and how many orders are still to read, and the buttons for opening the retailer, syncing it now and setting its history up again.
An order whose page shows no order is set aside. Sometimes a retailer opens an order's page with nothing on it (Walmart's header and no order, or its "Sorry" page). The sync leaves that order on the to-do list and opens it after the others next time, so one order cannot hold up the ones behind it. After three syncs it is set aside: syncs stop opening it, and the row says how many are. Its charges and total are already in SageFin; only its items are missing. A set-aside order is tried again if the retailer's list shows it has changed, or if you go back past it with Go further back (below).
How a sync knows it has caught up. At Amazon, new charges, refunds and late charges appear at the top of Your Payments, so a sync reads down the list until it reaches a charge it has already read, and stops there. At Walmart an order keeps changing for weeks (late shipments, substitutions, refunds), so a sync presses Next page until it has passed an order it has already read and is past the last 30 days or so.
When an update reads orders an earlier version left out, the row says History needs setting up again, to send orders an older version missed, with a Set up history again button. (SageFin Desktop 0.1.88 started reading Amazon's digital orders, such as Kindle books and subscriptions; a history set up before then left them out.) The button opens Your Payments with the strip, which now counts down to where your history went before: "reached August 12, 2026 of June 30, 2026" and "Go back to June 30, 2026, as far as your history went before". Scroll down until it says you are there, then press Done or close the window. Orders already read are skipped, so only the ones the earlier version missed go on the to-do list.
A sync cannot do that scrolling for you. Each sync starts at the top of the list, so reaching months back would mean one sync scrolling all the way down, which is what makes Amazon ask whether a person is there. That would stop the daily sync until you came back to it.
Setting up history again. Once a retailer's history is set up, its row's Details in Settings → Retail sync, inside SageFin Desktop, has Set up history again, which offers three things:
- Go further back opens setup again. Orders already read are skipped, and the strip says how many.
- Change how far back takes the orders on the to-do list older than a date you pick off it, so their pages are never opened. Their charges and totals are already in SageFin. The date starts at how far back the history reads now, so you only move it later. If the app cannot say, the date is empty and you pick one.
- Start over asks you to confirm first. Then the app forgets every order it has read for that retailer on this computer, and opens setup. Orders already in SageFin stay there: removing them is done in SageFin, not in the app.
The app also forgets on its own in two cases, and in both it behaves as if you had pressed Start over and asks you to set the history up again.
- SageFin has lost what the computer read. Restoring a household from a backup, or resetting it, removes SageFin's record of the orders this computer sent. The app checks before it opens a retailer, sees SageFin holds none, and forgets its own record so those orders are read again.
- The household or the person changes. The app keeps what it has read and the pages waiting to be sent for one household, and your choices about each retailer's terms for you. A household deleted and made again, or a member who moves to another household, starts fresh: no history set up, an empty to-do list, nothing counted as read. Pages captured for another household are never sent to this one. The earlier household's record is kept, sealed, if it can be recognized when you return; if it cannot, it is let go, and the retailers window says how many waiting pages were let go and not sent. Your terms choices go with you to another household, and someone else connecting the computer is asked for their own. Reconnecting the same computer in the same household keeps its memory. A computer that only loses its connection keeps its memory and does not hand it to whoever connects next.
The app's own Retailers on This Computer window, under its Retailers menu, has the same buttons. On a Mac that menu is in the menu bar at the top of the screen while SageFin Desktop is the app in front; it is out of sight only if your Mac is set to hide the menu bar, and moving the pointer to the top of the screen shows it. On Windows it is at the top of SageFin Desktop's window. If your copy of the app is older, Settings → Retail sync shows only Set up history, and these three are in that window.
What "SageFin cannot read 1 yet" means. Under Details, the line about what was sent counts pages SageFin read, could not read, and cannot read yet. "Cannot read yet" is a kind of page SageFin has no reader for: at Amazon, that is Your Orders, which the app saves when you open it. The orders it lists still reach SageFin, from Your Payments and each order's own page.
An Amazon order can arrive before its details do. The app reads Amazon's payments list first, which names each order and what was charged, then opens each order's own page for its date, items and total, at most twenty a sync. Until it has opened one, the order list shows the day it was charged and the amount, with Details not read yet where its items will go, or Digital order for one whose number starts D01: a Kindle book, a Prime Video rental, an app, a subscription or a membership fee. It may already read Matched: the match is on the charge, which is known. A later sync opens it and fills the rest in. Until then it is not split by category, because there are no items to split it by. Copies of the app from before digital orders were opened never open their pages, so a digital order that stays Digital order after a few syncs is the sign to update it.
Some digital orders have no Amazon charge to match. One whose page shows a total of $0.00, such as something included with a membership, reads No charge. One bought inside an app on an iPhone or iPad says Billed through Apple App Store on its page, because Apple took the money: the charge on your card is Apple's, and Apple often bills several subscriptions as one charge, so SageFin does not guess which charge was this order's. It reads Billed by Apple (or Billed by Google for Google Play). Neither reads Unmatched, and neither is counted in an alert that orders couldn't be matched. A digital order Amazon charged to your card, a Kindle book for example, is matched like any other order, whether your bank shows the charge as Amazon, Kindle or Prime Video.
To copy an order number, press the copy button beside it: in the order list, on the transaction the order matched, and on the phone's transaction screen.
An order with more than ten items opens showing its first eight, with Show all 41 items (or however many it has) under them; Show fewer folds them back. The card that paid, the transactions and the totals show either way.
Seeing your computers, and using more than one
Settings → Retail sync lists each computer you have connected, in any browser as well as in the app. For each it shows when the app last checked in with SageFin and what each retailer's last sync there came to: how many orders it read, or that the retailer turned it away, or that it met a sign-in page. So a sync that needs you shows up without opening the app on that computer.
Two things that list cannot know, and says so:
- Whether you are signed in to a retailer right now. The app learns that by loading a page, so "needed a sign-in" is as of the last sync, not this minute.
- Why a computer has gone quiet. One that is switched off and one where the app has been quit look the same: both are "last seen" some time ago.
With SageFin Desktop on more than one computer, only one syncs each retailer daily: whichever synced it last. When each retailer syncs by itself, on the same page, names that computer beside each retailer. If that computer stops running for about two days, another takes over by itself. Sync now works on any of them and makes that computer the one that syncs daily. And if a retailer turns a sync away on one computer, the daily sync stops on all of them until you press Sync now.
That sharing needs a recent SageFin Desktop on every computer. An old copy does not take part: it syncs on its own schedule whatever your other computers do, so a retailer can see two daily syncs where you meant one, and it is not told when a retailer has turned another computer away. The list marks such a computer as too old and says to update it. A copy that is newer than that, but older than SageFin now requires, stops syncing by itself until it is updated; Sync now on that computer still works.
One daily sync per retailer account, and each account's orders kept apart. If two of your computers are signed in to different accounts at a retailer, each account keeps its own daily sync, one being turned away does not stop the other, and their orders are listed as two logins and not mixed into one.
- Walmart says which account a page belongs to, so SageFin tells them apart by itself. It keeps only a scrambled form of the account's id, never the id.
- Amazon's pages do not say. If your computers are on different Amazon accounts, open SageFin Desktop on each, go to Settings → Retail sync, and under Amazon give the account a name ("Alex's Amazon"). Use the same name on every computer signed in to that account. With one Amazon account, leave it empty: nothing needs naming.
You can start a sync from that list without being at the computer. Request sync beside a retailer asks that computer to sync it. It is a request, which is why it is not called Sync now. The app picks the request up the next time it checks in, so the sync starts within a few minutes, not at once, and only if the app is running there; a request nobody picks up lapses after fifteen minutes. It runs the way the daily sync does: slowly, out of the way, and it stops if the retailer asks for a person.
The same list, and Request sync, are in the SageFin phone app under Settings → Retail sync, so you can see what a computer at home last did, and ask it to sync, from wherever you are.
So the button is only there when the daily sync could run on that computer. It is not offered until you have synced that retailer there once yourself and chosen to let the app sync it by itself, nor after a sync there met a sign-in page or the retailer turned one away. Those need you at the computer, and the list says which.
The app does this by checking in with SageFin every few minutes. It sends its version and, for each retailer, when its last sync ran, how it ended, and whether you have let it sync that retailer by itself. It sends nothing from a retailer's pages that way. What comes back is whether this computer may run the daily sync, and any sync you have asked it to start.
A second computer does not read your order history again. During a sync the app asks SageFin which of the orders it can see another of your computers has already read, and opens only the rest. It asks with a scrambled code for each order, made from the order number and its current state, not the order number itself, and nothing else from the page. An order that has changed since, such as one that was refunded, is read again. This only works between computers signed in to the same account at that retailer.
Choosing when a retailer syncs by itself
By default a retailer syncs again a day after its last sync finished, so the time drifts to whenever you last pressed Sync now. Settings → Retail sync has When each retailer syncs by itself, with a row for each retailer that says how often it syncs, on which of your computers, and when the next one is due. There you can set, for each retailer:
- About what time. Pick an hour, and the scheduled sync runs around then: the app looks once an hour, so it starts within the hour after. The hour is on the clock of the computer that does the syncing. Choose a time that computer is on; a sync that was due while it was off or asleep runs when it is next awake. A scheduled sync never starts within six hours of the last one, so a sync just before the hour does not run again that morning, and an evening Sync now leaves the next morning's in place.
- How often. Every day, every two or three days, or every week. Nothing more often than daily is offered: every sync loads the retailer's pages, and more of them make it likelier the retailer turns one away.
One thing overrides both. A sync opens at most twenty orders. When one opens all twenty and more are still on the to-do list, after setting up your history or a long gap, the next starts about an hour later instead, and so on until the list is empty. Then your chosen time is back. Each of those syncs is as slow and as small as any other; they are only closer together, and the row's "next one is due" says so.
It is one setting per retailer, kept by SageFin, so it stays the same whichever of your computers does the syncing. Sync now and Request sync work at any time and do not move it. A change reaches the computer within a few minutes, the next time the app checks in.
The SageFin phone app shows the same thing under Settings → Retail sync: for each retailer, how often it syncs, on which computer, and when the next one is due. How often and About what time under each retailer change the same setting.
What each retailer's terms say
A retailer's terms of use are between you and the retailer, and they decide whether a tool may read your account for you. They differ, and you should know what each says before you use a sync.
The app asks before it does anything a retailer's terms prohibit. In SageFin Desktop, each retailer on Settings → Retail sync shows what its terms say, in the retailer's own words, with their date and a link. Where they prohibit it, saving your orders pages and syncing them are two choices that are off until you turn them on, and Sync now waits for them. Your choice is kept with the date of the terms it was about; if the retailer changes its terms, the app stops there and asks again. Choosing changes whether the app does this, never how: it is as slow, and stops as readily, either way.
Walmart's terms prohibit it. Walmart's terms of use, updated September 9, 2026, say you will not use "any robot, spider … or other manual or automatic device" to gather what its site shows, or "systematically download and store" it, without Walmart's written consent. SageFin Desktop's Walmart sync does both, for your own orders on your own account. Walmart may restrict an account for any reason, so using the sync is a risk you choose to take or not.
Amazon's terms allow it, on conditions the app meets. Amazon's terms, updated August 14, 2026, allow software that acts for you if it says what it is on every request, never imitates a person or answers a robot check, and stops when Amazon turns it away. SageFin Desktop's Amazon sync tells Amazon it is an agent, and stops the first time Amazon refuses it.
Costco's terms have not been read yet, which is one reason Costco is not in the app.
Syncing, and re-matching
Two different things, easy to confuse:
Sync now, in SageFin Desktop, goes out to the retailer and reads orders. It is slow on purpose: it opens one page at a time, a few seconds apart, the way a person would read them.
Re-match touches no retailer at all. It takes the orders already fetched and runs them against your transactions again, which is what you want after importing older transactions or fixing a date. It finishes in seconds.
You rarely need it for a new order. A retailer usually charges a day or a few after the order, so an order synced the day you placed it often has nothing to pair with yet. Each time your bank sends new transactions, SageFin matches any order from the last 30 days that is still unmatched, so the order pairs up once the charge arrives.
If an order and a charge did not pair up, re-match first. Only sync again if the order itself is missing.
What is kept, and what is not
Order, receipt and item details are stored with your household's data — the amounts, what was in each order, and the dates. The privacy policy is the complete account of that.
SageFin Desktop keeps your retailer sign-ins on your computer, so SageFin holds none. If you download everything, your orders come with you.
When an order will not match
An order that reads Unmatched says why, above Match to a transaction…, in the words SageFin recorded the last time it looked for the order's charge. The reasons it gives:
More than one charge could be it. SageFin does not guess which; see two identical orders below. When the order names the card that paid, and SageFin knows which account that card is, it settles this itself by looking only at that account's charges — see which card paid. An order still reading this either has no card SageFin knows, or more than one charge on the card's own account.
One charge could be this order or another one. The same refusal from the other side: two orders both point at the one charge, so neither takes it.
The only charge that looks like it is already matched to another store's order. Each charge is matched to one order, and that one went first. If it is the wrong one, match this order yourself.
The card isn't one of your accounts in SageFin. The order shows the card that paid, such as Paid with card ••3661, and none of your accounts in SageFin is that card, so its charge is not here to find. An HSA or FSA card is the usual example. Link that account to bring its charges in. SageFin says this only when it knows your accounts' last four digits, which it reads from your bank the next time an account syncs, and only when no matched order was paid with that card either.
No charge was found near the order's date. SageFin looks for a charge within five days of the order. The charge may not have posted yet, or your bank may have dated it further away than that.
The order has no date, or no amount, to look for. Usually an order SageFin knows only part of so far; it fills in when the order's page is read.
SageFin hasn't recorded why. An order last looked at before SageFin kept its reasons says so rather than guess one. Rematch orders records it, and so does the next sync that reaches the order.
Some causes behind those:
The charge and the order have different amounts. A split shipment charges you per shipment while the order shows the whole basket. Re-match will not fix this; the two genuinely are different numbers.
The charge is older than the orders fetched. A sync reaches back a limited way. Orders from years ago will not appear.
It is a gift card, or a subscription billed by somebody else. These often bill separately from any order, and there is nothing to match them to. An Amazon order billed through Apple reads Billed by Apple rather than Unmatched, for that reason.
Two orders that cost the same, charged on different days. If you placed two identical orders, say two at $5.26, and your bank shows two $5.26 charges on different days, each order could be either charge. SageFin does not guess which, so both read Unmatched. You can tell them apart; see below.
Matching an order yourself
On an order that reads Unmatched, open it in the Retail sync tab and press Match to a transaction…. Search by merchant, description or account; the search starts a week before the order's date and runs two weeks after it, and you can widen it. Charges for exactly the order's amount are listed first, then the rest nearest the order's date, with Show more for the next twenty. Pick the charge the order was. A pending charge cannot be picked: it is replaced when it posts, so pick it once it has.
What happens next is what happens when SageFin matches an order itself. The order reads Matched, its transaction says matched by you, and the items appear on the transaction, split by category where the order's figures add up. SageFin then re-matches your other orders, so the other of two identical orders now has only one charge left and matches it on its own.
Your match is kept. Syncs, re-reading the order and Rematch orders all leave it as it is, and the charge you picked is never matched to another order. If SageFin had already matched that charge to a different order, your choice wins and that order is looked for again. A charge you matched to one order cannot be matched by hand to another; unmatch it there first.
Unmatch on an order you matched takes your match away. The transaction stays as it is, including any splits the order added. SageFin then looks for the order on its own again: it may match the same charge, a different one, or leave the order Unmatched as it was before.
Which card paid
An Amazon order's own page says which card paid, and the order shows it: Paid with Visa ••4242. SageFin keeps only the card's brand and its last four digits, never more of the number. An order whose page has not been read since this was added shows the last four from its charge instead, as Paid with card ••4242, and the brand appears the next time SageFin Desktop opens that order's page. Orders whose page is not opened again keep showing the last four only.
The card helps pick the charge. When several charges could be an order, SageFin looks at which card paid. It knows a card is one of your accounts when that account's last four digits are the card's, which is true of most credit cards, or when you have matched an order paid with that card to one of the account's charges yourself, or when another order paid with it matched on its own. A debit card is usually known the second or third way, because a checking or HSA account's last four are the account's number, not the card's. If exactly one of the charges is on the card's account, the order matches it. If the card could be more than one account, or none of the charges is on its account, SageFin leaves the order as it would have without the card.
Asking Sage about an order
Sage can read your retailer orders the way the Retail Sync panel lists them, so you can ask it "which Amazon orders are unmatched?", "what did I buy at Costco in October?" or "which card paid for that Walmart order?" It sees what each order held, its totals, the transaction it matched and the card that paid, by brand and last four only, and the reason an unmatched order gives. It only reads: to match or unmatch an order, use the panel.