Log spending from your iPhone
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
- With the Heartdue app: open it, go to Spending → Phones and answer one question. The app shows you each step.
- Without the app: on your iPhone, open Heartdue in Safari, go to Spending → Phones → Connect a phone, choose iPhone, open Set up without the app and tap Create key. Keep that screen open; it shows your key with a Copy button.
- That key is shown once. If you lose it, remove the phone and add it again; it takes seconds.
You'll need iOS 17 or later (Settings → General → About → iOS Version), and one of these: your bank's app on iOS 27 or newer, your bank's texts arriving on this iPhone, or a card in Apple Wallet.
Set up the Shortcut
Easiest: with the Heartdue app
About two minutes. The app asks one question, then shows only the steps for your answer.
- Open the Heartdue app on your iPhone and sign in.
- Go to Spending → Phones.
- Answer its one question, then follow the steps. Here they are for each answer:
When you pay by card, what does your iPhone show?
Both? Pick your bank's app: there's nothing to type.
Don't have the app yet? Get it from the App Store.
Setting this up for someone else? Do it on their iPhone, in their Heartdue app: the key is made and copied there.
Other ways to set it up (without the app)
On iOS 27 or newer: one link sets it all up
About two minutes. Pick the way your bank tells you about a payment, and only one: with both, one payment could show up twice. Your bank does both? Pick its app: there's nothing to type.
Not sure which iOS you have? Settings → General → About → iOS Version.
Your bank's app tells you when you pay
- Tap Copy to copy your key. No key yet? On this iPhone, open Heartdue in Safari: Spending → Phones → Connect a phone → iPhone → Set up without the app → Create key.
- Tap Get the Heartdue shortcut, then Add Shortcut. Paste your key where it asks, then pick your bank's app. If Add Shortcut doesn't respond after you pick the app, tap Skip Setup: your key and the app are kept.
- Open the Shortcuts app and tap Heartdue. If it says the automation is turned off, tap the arrow next to When I receive a notification and switch Automation on.
- Test it: tap ▶ on Heartdue. You should see “Connected!”. Asked about heartdue.com? Tap Always Allow.
Your bank texts you
- Tap Copy to copy your key. No key yet? On this iPhone, open Heartdue in Safari: Spending → Phones → Connect a phone → iPhone → Set up without the app → Create key.
- Tap Get the Heartdue shortcut for texts, then Add Shortcut. Paste your key where it asks.
- Open the Shortcuts app and tap Heartdue texts. Tap the blue Your bank words and type words that are in every payment text from your bank, exactly as your bank writes them. For example:
- Your bank's texts say “Card ending 1234”? Type your card's last 4 digits: 1234.
- They say “Remaining balance is”? Type Remaining balance is.
- They say “debited from your account”? Type debited from your account.
Pick words your friends wouldn't text you.
- Tap the arrow next to When I receive a message and switch Automation on.
- Test it: tap ▶ on Heartdue texts. You should see “Connected!”. Asked about heartdue.com? Tap Always Allow.
Heartdue pops up only when it logs a payment or something needs fixing: never for a code, an advert or a payment it already has.
With your bank's app, every notification from that app goes to Heartdue, and nothing from any other app. One-time codes, adverts and declined payments are thrown away the moment they arrive, and never go to the AI. The rest is read for a payment, with card and account numbers hidden first. Heartdue keeps just the amount, the shop and the date.
On iOS 26 or older? Set it up this way
Quick setup (recommended)
About two minutes. Your bank texts you each time you pay by card, online too. The Heartdue shortcut reads those texts for you.
- Tap Copy to copy your key. No key yet? On this iPhone, open Heartdue in Safari: Spending → Phones → Connect a phone → iPhone → Set up without the app → Create key.
- Tap Get the Heartdue shortcut. Paste your key where it asks, then tap Add Shortcut.

- Test it: in the Shortcuts app, tap Heartdue once. You should see “Connected!”. Asked about heartdue.com? Tap Always Allow. It says the key isn't valid? Tap ••• on the shortcut, clear the top box and paste your key again.
- Tap Automation at the bottom, then New Automation (or +). Tap Message.

- Tap Message Contains and type words that are in every payment text from your bank. Type them exactly as your bank writes them: same spelling, same spaces. For example:
- Your bank's texts say “Card ending 1234”? Type your card's last 4 digits: 1234.
- They say “Remaining balance is”? Type Remaining balance is.
- They say “debited from your account”? Type debited from your account.
Pick words your friends wouldn't text you. Your bank isn't under Sender? That's normal: Sender only lists your contacts, and banks text from a name.
- Tap Run Immediately, then Next.

- Tap Heartdue. Done! Cards with different last 4 digits? Make one automation for each.

To check it, text yourself something like “You spent 12.50 at Test Shop”, with the words you typed in it. It shows up on Spending, and you can delete it there.
Heartdue reads each text for the amount, the shop and the date, and keeps nothing else. A text with a one-time code, or with no payment in it, is thrown away the moment it arrives.
Your bank doesn't text you? Use Apple Pay instead
Your bank's alerts only come in its own app? On iOS 27 or newer, use the bank's app way above. On an older iPhone, turn on the bank's text (SMS) alerts if it has them: before iOS 27, no app can read another app's notifications. Without texts, Apple only tells Shortcuts about payments you make by tapping your iPhone or Apple Watch in a shop. So this way logs those, but not online payments:
- Open the Shortcuts app → Automation tab → New Automation (or +). Scroll down and tap Wallet (Transaction on some iPhones).

- Leave all your cards and categories ticked, and the merchants as they are. Choose Run Immediately, tap Next, then Create New Shortcut (New Blank Automation on some iPhones).

- Search the actions for Text and tap it. In the box type
amount:then tap Shortcut Input above the keyboard and pick Amount. On a new line typemerchant:and pick Merchant; on a third linecard:and pick Card or Pass. - Search the actions again for Run Shortcut, tap it and pick Heartdue. Tap ✓ (Done). That's it.

Your bank's texts already set up above? Skip this: with both, one payment can show up twice.
Check it works: pay for something with Apple Pay: a notification shows Heartdue's reply, and the payment appears on the Spending page. (Tapping ▶ in the automation sends no payment, so Heartdue answers “Connected!” and logs nothing.)
Set it up by hand
The Apple Pay way, for an iPhone that can't add the Heartdue shortcut: about five minutes. Skip it if your bank's texts are set up: with both, one payment can show up twice.
- Open the Shortcuts app, go to the Automation tab and tap New Automation (or +).

- Scroll down and choose Wallet (Transaction on some iPhones).

- Leave your cards ticked (or only the ones you want tracked), and the categories and merchants as they are. Choose Run Immediately, then tap Next.

- Tap Create New Shortcut (New Blank Automation on some iPhones) and search the actions for Get Contents of URL.

- Tap URL and paste:
https://heartdue.com/api/phone/payment - Tap the › arrow on the action to show more options, and set Method to POST.
- Under Headers, tap Add new header. Key:
Authorization. Value:Bearer YOUR-PHONE-KEY(the word Bearer, one space, then the key). - Set Request Body to JSON and add three Text fields. For each value, tap it, choose Shortcut Input, then tap that and pick the detail:
amount→ Amountmerchant→ Merchantcard→ Card or Pass (called Name on some iOS versions; optional)

- Optional but handy: add a Show Notification action and pick Contents of URL, so you see Heartdue's reply after each payment.
- Tap ✓ (Done).
Check it works: open the automation and tap ▶. There's no payment, so Heartdue replies “Connected!” and logs nothing. Your next Apple Pay payment will appear on the Spending page.
What it logs
- On iOS 27 or newer, with your bank's app: every payment its notifications tell you about.
- Every card payment your bank texts you about, online shopping included.
- Without texts from your bank: paying in a shop by tapping your iPhone or Apple Watch (Apple Pay).
Apple tells Shortcuts only about tapping to pay, not about App Store purchases or shopping online. Those come from your bank's texts. Paid by bank transfer or cash? Add it on the Spending page.
What gets sent, and what Heartdue keeps
- Only what you set it up for. The shortcut runs only when one of these happens: a text arrives with your card's last 4 digits (or the words you chose from your bank's texts); your bank's app sends a notification (on iOS 27, if you picked it); or you pay with Apple Pay.
- With your bank's app (iOS 27), it sends the text of each of that app's notifications. A one-time code is thrown away as it arrives, without ever going to the AI, and so are adverts and declined payments.
- It sends each of those texts whole. Heartdue keeps only the amount, the shop and the date. A text with a one-time code is thrown away as it arrives, and one with no payment in it once it's read. To read a text, Heartdue may pass it to its AI provider, with card and account numbers hidden first. With Apple Pay it sends three things: the amount, the merchant, and your card's name as it appears in Wallet (for example “Visa Debit”).
- Heartdue keeps the amount, merchant, the card's name with any digits removed, the 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 and nothing else. It can't read your bills, budget or 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.
- Set up with a key? Treat it like a password. Don't screenshot that Shortcut or share it: the key is inside it. If you think someone else has it, remove the phone in Heartdue and the key stops working at once. (With the Heartdue app there's no key to lose: it stays in the app.)
Troubleshooting
The Heartdue shortcut shows Heartdue's reply as a notification each time it runs. Built it by hand? Add a Show Notification action at the end and pick Contents of URL.
- Connected!
- The key works. Nothing was logged because there was no payment: that's what a test shows. See this right after paying, with a Shortcut you built by hand? Its amount field is empty. Set it to Shortcut Input → Amount.
- Connected. That message didn't look like a payment
- A text with no payment in it, like a one-time code. Nothing was kept, and there's 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.
- …pausing it for a while
- More than 30 payments in an hour from one phone. It picks up again on its own.
- Couldn't read an amount
- The amount sent isn't a number. In your Apple Pay automation, check the <code>amount:</code> line (or field) is Shortcut Input → Amount.
| Reply | What it means |
|---|---|
| Connected! | The key works. Nothing was logged because there was no payment: that's what a test shows. See this right after paying, with a Shortcut you built by hand? Its amount field is empty. Set it to Shortcut Input → Amount. |
| Connected. That message didn't look like a payment | A text with no payment in it, like a one-time code. Nothing was kept, and there's 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. |
| …pausing it for a while | More than 30 payments in an hour from one phone. It picks up again on its own. |
| Couldn't read an amount | The amount sent isn't a number. In your Apple Pay automation, check the <code>amount:</code> line (or field) is Shortcut Input → Amount. |
- Nothing happens after paying: open the automation and check it says Run Immediately. For texts, check Message Contains has your card's last 4 digits, or words from your bank's payment texts, exactly as your bank writes them. For Apple Pay, check the card you paid with is ticked.
- You get asked “Allow … to connect?”: tap Always Allow. iOS asks once per website.
- “Card payment” instead of the shop's name: your bank's text doesn't name the shop, so Heartdue can't either. With Apple Pay, check the
merchant:line is Shortcut Input → Merchant. - Wallet (or Transaction) isn't in the list of automations: your iPhone needs iOS 17 or later.
- 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: with the Heartdue app's Log a payment or Read a text, the payment waits on your iPhone. It's sent with your next payment, or when you open Heartdue, with the date you paid. Without the app, the Heartdue shortcut can't keep it: add it on the Spending page.
- On iOS 27, nothing happens: open the Heartdue shortcut, tap the arrow next to When I receive… and check Automation is on. With your bank's app, check the app it names is your bank's.
Turning it off
- In Heartdue, open Spending → Phones and tap Remove phone. The key stops working at once; spending already logged stays.
- In the Shortcuts app, open Automation, swipe left on the Message automation (and the Wallet one if you made it, Transaction on some iPhones) and tap Delete.