Log spending from your Android
Pay the way you always do. A moment later, the amount and the shop appear in Heartdue. Each payment comes off your budget, goes into a category, and is matched to a bill if it paid one. No bank login, and nothing to type.
Before you start
- Install Heartdue from Google Play (Android 8 or later) and sign in.
- There's no key to copy: the app connects itself when you agree, under Spending → Phones.
Make sure your bank tells you when you pay, by app notification, text message or email. If it doesn't, switch on payment alerts in the bank's app first. That alert is what Heartdue reads.
Set up the Heartdue app
The Heartdue app from Google Play reads the payment alerts your bank already sends, and logs them for you. They can come in the bank's app, by text, by email or in a chat app. No key to copy, and it takes about two minutes.
- On your Android phone, get Heartdue on Google Play, open it and sign in.

- Tap Spending, then Phones. Read What switching this on means and tap I agree. Connect this phone. Heartdue's phone screen opens by itself.

- Under Let Heartdue read notifications, tap Turn on. Switch on Allow notification access and tap Allow. Back in Heartdue it says Turned on ✓. (On Android 10 or older, switch Heartdue on in the list.)


- Further down, under Apps Heartdue reads, check your bank is there. Heartdue finds banks and payment apps by itself. If one is missing, tap Add an app. Your bank's texts, emails and chat messages are read too.

- On a Samsung, Xiaomi or Huawei phone, also tap App settings → Battery → Unrestricted, so the phone doesn't put Heartdue to sleep.

Check it works: on that screen, tap Send a test. It says “Connected!” and logs nothing. A moment after your next card payment, it shows under Recent there and on your Spending page. To get back to that screen: Spending → Phones → Notification access and apps.

What it logs
- Card payments, tapping your phone to pay, and online purchases, whenever your bank or wallet tells you — by app notification, by text, by email or in a chat app.
- Refunds, when the bank's message says so.
- Bills that change in amount each time, when the company sends them by text, email or in its app. Their amount and due date go on that bill, never into your spending.
Anything your bank doesn't tell you about won't appear, and neither will cash. Add those on the Spending page. Messages that aren't payments are ignored.
What gets sent, and what Heartdue keeps
- Payment alerts, and your bills. Heartdue reads notifications from banks, cards and payment apps, and what your bank sends by text, email or chat app. It sends only the ones that read like a payment, with an amount in them. An app or sender you add yourself is sent in full, for Heartdue to sort. It never sends one-time codes, group chats, or chats and emails from people. A text from a saved contact goes only if it reads like a payment.
- Bills that change in amount each time. A company's message that a bill has come is sent if its sender's name matches one of your bills, or once you tap Add next to that sender in the Heartdue app. Heartdue keeps the amount, the due date and the account's last digits on that bill. It never keeps the message, and never counts it as spending.
- It sends that alert's title and all of its text, including the other lines it shows, but never a line that names a code. Heartdue picks out the amount and the shop. It throws the rest away without storing it, including any balance or card digits.
- Heartdue keeps the amount, shop, date and a category. Never a card number, and never a balance.
- Your key is stored only as a scrambled fingerprint. It can add spending to one profile. It can also tell the Heartdue app the names of the companies whose bills change in amount, and only their names. It can't read your bills' amounts, your budget or your balances. The one exception: if you switch on “Show what's left” for this phone, its replies and home-screen widgets show what's left, your next bills and how your promise is going.
- Who sees it: you, and anyone in your Trusted Circle you've given Full view.
- No key to look after. The app keeps it and never shows it. If you lose the phone, remove it in Heartdue and its key stops working at once.
Troubleshooting
In Heartdue, go to Spending → Phones → Notification access and apps. Its Recent list shows each payment the phone sent, and what Heartdue replied.
- Connected!
- The key works. Nothing was logged because there was no payment; that's what Send a test shows.
- Connected. That message didn't look like a payment
- An alert with no payment in it, like a login notice. Nothing to fix.
- Logged 12.50 at …
- Saved. It's on the Spending page.
- That's your … bill
- It was matched to a bill on your list, which is now marked paid. It isn't added to your spending as well.
- Already logged
- The same payment arrived twice (usually a slow connection). The repeat was ignored.
- This phone's key isn't valid any more
- The phone was removed in Heartdue, or the key was pasted wrongly. Add the phone again for a fresh key.
- No connection — will send when there is one.
- No answer yet. There may be no signal, Heartdue may be busy, or the phone sent more than 30 payments in an hour. The payment waits on the phone and is sent by itself, with the date you paid.
- Android hid this message from Heartdue
- Android 15 and later hide messages they think contain a code, and “card ending 1234” looks like one. Turn off Settings → Notifications → Enhanced notifications.
| Reply | What it means |
|---|---|
| Connected! | The key works. Nothing was logged because there was no payment; that's what Send a test shows. |
| Connected. That message didn't look like a payment | An alert with no payment in it, like a login notice. Nothing to fix. |
| Logged 12.50 at … | Saved. It's on the Spending page. |
| That's your … bill | It was matched to a bill on your list, which is now marked paid. It isn't added to your spending as well. |
| Already logged | The same payment arrived twice (usually a slow connection). The repeat was ignored. |
| This phone's key isn't valid any more | The phone was removed in Heartdue, or the key was pasted wrongly. Add the phone again for a fresh key. |
| No connection — will send when there is one. | No answer yet. There may be no signal, Heartdue may be busy, or the phone sent more than 30 payments in an hour. The payment waits on the phone and is sent by itself, with the date you paid. |
| Android hid this message from Heartdue | Android 15 and later hide messages they think contain a code, and “card ending 1234” looks like one. Turn off Settings → Notifications → Enhanced notifications. |
- Nothing happens after paying: open Spending → Phones. It should say “It's reading payment notifications.” If not, tap Notification access and apps. Step 2 should say Turned on ✓, and your bank should be under Apps Heartdue reads (or send you texts).
- Works for a while, then stops: Android may be putting Heartdue to sleep. Go to Settings → Apps → Heartdue → Battery and choose Unrestricted.
- “Android hid this message” in Recent: Android 15 and later hide texts they think hold a code. Turn off Settings → Notifications → Enhanced notifications.
- A shopping or delivery app is being read: remove it under Apps Heartdue reads, so an order and its card payment don't both show up.
- Your bank tells you about one purchase in several ways: Heartdue nearly always shows it once. If one shows up twice, keep one app per card under Apps Heartdue reads.
- Wrong amount: some banks mention your balance before the payment. Heartdue skips numbers labelled as a balance or limit, but if one slips through, fix or delete the entry on the Spending page.
- “Card payment” instead of the shop's name: your bank doesn't name the merchant in its notification, so Heartdue can't either. If the name matters, delete the entry on the Spending page and add it by hand.
- Wrong category: change it on the Spending page. Heartdue remembers and files that merchant the same way next time.
- A payment shows up crossed out: it was matched to a bill already on your list, so it isn't added to your spending as well. Tap Not this bill if that's wrong.
- Paid with no signal: Heartdue keeps the payment on your phone and sends it once you're back online, with the date you paid. Recent shows it's waiting, then what happened to it.
Turning it off
- In Heartdue, open Spending → Phones, tap Remove phone, then Remove. The key stops working at once, and spending already logged stays. If you do this in the app on that phone, it also stops reading.
- To stop it reading altogether, open Android's Settings, search for Notification access, open Heartdue and switch it off, or uninstall the app.