WalletFeed

Send Apple Card transactions to Sure

WalletFeed sends your Apple Card, Apple Cash and Savings transactions from your iPhone to Sure. Sure is a self-hosted budget app that is a fork of Maybe Finance. You add a card account and make an API key in Sure. Then you paste the key in WalletFeed.

Before you start

You must have these items:

Your key stays on your iPhone

Step 1: Get an HTTPS address for your Sure server

WalletFeed connects only to an address that starts with https://. With Background Sync, WalletFeed also sends transactions when your iPhone is not on your home network. Thus, your iPhone must connect to the address from all locations.

If you install Sure with Docker and do not change its configuration, Sure uses an http:// address on port 3000. WalletFeed cannot use this address. A tunnel service, for example Tailscale or Cloudflare Tunnel, can give Sure an https:// address.

  1. If the address of your Sure server starts with http://, make an https:// address with a tunnel service.

  2. If a tunnel service gives Sure its https:// address, set RAILS_ASSUME_SSL: "true" in the Sure configuration.

    The HTTPS section of the Docker instructions for Sure gives more information.

  3. Disconnect your iPhone from your home Wi-Fi.

  4. On your iPhone, open the https:// address of your Sure server in Safari.

  5. Make sure that Sure opens.

Step 2: Add a card account in Sure

WalletFeed writes the transactions to one account in Sure. The Sure API cannot make accounts. Thus, you must add the account in Sure first.

  1. On your computer, open your Sure server in a web browser.

  2. If a What's new dialog opens, click Got it.

  3. On Home › Dashboard, click Add account or New.

    The Sure dashboard with no accounts and the Add account button highlighted.

  4. Click Credit Card.

    The Sure dialog that shows the account types, with Credit Card highlighted.

  5. Click Enter account balance.

    The Sure dialog that shows the procedures to add the card, with Enter account balance highlighted.

  6. In Account name, type Apple Card.

  7. In Balance on date:, type 0, or type the card balance on the Opening balance date.

  8. Click Create Account.

    The credit card form in Sure with the name Apple Card, and with the Create Account button highlighted.

Step 3: Make a Read/Write API key in Sure

WalletFeed uses the key to read your Sure accounts and to write transactions. With Universal Clipboard, you can copy the key on a Mac and paste it on your iPhone.

  1. On your computer, open your Sure server in a web browser.

  2. At the bottom of the left bar, click the button that shows the first letters of your name.

    The Sure account page with the button at the bottom of the left bar highlighted.

  3. Click Settings.

    The Sure account menu, with Settings highlighted.

  4. In the Settings list, scroll to the ADVANCED group.

  5. Click API Keys.

    The Sure Settings list with API Keys highlighted in the ADVANCED group.

  6. Click New API Key.

    The API Keys page in Sure, with no keys and the New API Key button highlighted.

  7. In API Key Name, type WalletFeed.

  8. In Permissions, click Read/Write.

    The page for a new key in Sure with the name WalletFeed, and with the Read/Write permission highlighted.

  9. Click Save API Key.

    The page for a new key in Sure, with the Save API Key button highlighted.

  10. Click Copy API Key.

    The API Key Created Successfully page in Sure, with the Copy API Key button highlighted.

To make the key on your iPhone, do these steps:

  1. In WalletFeed, do steps 1 to 5 of Step 4.
  2. Tap Open API Keys. Your web browser opens the API Keys page of your Sure server.
  3. If Sure shows its sign-in page, get access to your Sure account.
  4. If Sure then shows its dashboard, tap Open API Keys in WalletFeed again.
  5. On the API Keys page, do steps 6 to 10 of the first procedure in Step 3.
  6. Open WalletFeed again.
  7. Do steps 6 to 10 of Step 4.

Step 4: Add Sure in WalletFeed

  1. On your iPhone, open WalletFeed.

  2. Tap Destinations.

  3. Tap + at the top of the screen.

    The empty Destinations screen with the + button at the top.

  4. In Budgeting, tap Sure. If you do not have WalletFeed Pro, WalletFeed first shows the WalletFeed Pro screen.

    The Add Destination list, with Sure and the text Self-hosted in the Budgeting group.

  5. In the field that shows https://sure.example.com, type the https:// address of your Sure server.

    The WalletFeed screen for Sure with the server field, the API Key field and three steps.

  6. In API Key, paste the key. WalletFeed connects to Sure and shows Account.

  7. In Account, select your card account.

    If an account has Apple Card in its name, WalletFeed selects that account for you. If no account has Apple Card in its name, WalletFeed selects a credit card account.

  8. Tap Add.

  9. In the Send Transactions to Sure? message, tap Send.

    The message tells you the data that Sure will receive, the Wallet accounts and the start date.

  10. On your computer, click Transactions in Sure. Sure shows the transactions from WalletFeed in the list.

    The Sure Transactions page with seven sample transactions from WalletFeed in the Apple Card account.

Data that Sure receives

WalletFeed sends these fields for each transaction to the Sure account that you selected:

From Wallet In Sure
The date of the transaction, in your time zone Date
The merchant name, or the description if there is no merchant name Name
The amount Amount. A purchase is an expense, and a refund or other credit is income.
The currency Currency
The ID of the transaction in Wallet An ID that WalletFeed uses to change the transaction

WalletFeed does not send categories. Sure shows new transactions as Uncategorized until you give them a category.

Sure shows a purchase with a minus sign, for example -$6.75, and a refund in green without a minus sign. The Debt balance of the card increases with each purchase.

WalletFeed has no account and no WalletFeed servers. Thus, your iPhone sends the transactions directly to your Sure server. The server address and the key stay in the Keychain on your iPhone.

New and changed transactions

While WalletFeed is open, Sure receives changes in seconds. When WalletFeed is not open, iOS starts WalletFeed approximately 1 hour or less after a change in Wallet. If Background Sync is on in Settings › Sync, WalletFeed then sends the change.

WalletFeed sends a pending charge to Sure. Sure does not show that the charge is pending. When Wallet shows the charge as posted, the date or the amount can change. Then WalletFeed makes the same change in Sure. WalletFeed does not change the name, category, merchant, tags and notes that you set in Sure.

If Wallet removes a pending charge, for example a declined charge, WalletFeed deletes the transaction from Sure. WalletFeed deletes only transactions from the last 90 days.

If WalletFeed sends a transaction again, Sure does not make a second copy. Sure keeps one transaction for each Wallet transaction.

Send previous transactions

A new destination also receives previous transactions from the start date in Settings › Sync › Initial History. Initial History is All until you change it.

You can also send previous transactions with Send History:

  1. In WalletFeed, tap Destinations.
  2. Tap the Sure destination, for example Sure · Apple Card.
  3. Tap Send History.
  4. Tap 30 Days, 90 Days, 1 Year or All. WalletFeed shows Sending History with the number of transactions that it sent.

To stop Send History before WalletFeed sends all of the transactions, tap Send History › Stop Sending.

Change or remove the destination

To open the Sure destination, do these steps:

  1. In WalletFeed, tap Destinations.
  2. Tap the Sure destination.

For more information, refer to Destinations.

Send only some transactions

  1. Set Filter to on.
  2. Select the transactions with Include, Minimum, Include Pending, Accounts, Categories and Exclude.

To send only Apple Card transactions to this destination, select Apple Card in Accounts.

For more information, refer to Choose what a destination receives.

Replace the key

  1. Make a new Read/Write key in Sure, as in Step 3. While the previous key is active, the new key must have a different name, for example WalletFeed 2.
  2. In the Sure destination, tap Replace Key.
  3. In API Key, paste the new key.
  4. Tap Replace.

WalletFeed keeps the new key only if the key can read the card account and write transactions.

Stop or remove the destination

To stop the destination but not remove it, set Enabled to off.

To remove the destination, do these steps:

  1. In the Sure destination, tap Delete.

  2. In the Delete Sure · Apple Card? message, tap Delete.

  3. On your computer, open Settings › API Keys in Sure.

  4. Click Revoke for the WalletFeed key.

    The API Keys list in Sure, with the Revoke button for the WalletFeed key highlighted.

  5. Click Confirm.

    The Sure dialog about the WalletFeed key, with Confirm highlighted.

If you remove the destination, the transactions that WalletFeed sent stay in Sure.

If there is a problem

If WalletFeed does not show Account or Open API Keys

The address starts with http://. WalletFeed connects only to https:// addresses, and it shows no message for an http:// address.

  1. Get an https:// address for your Sure server, as in Step 1.
  2. In WalletFeed, type the https:// address.

If WalletFeed shows "Create an account in Sure"

When Sure has no accounts, WalletFeed shows "Create an account in Sure for your card, then try again."

  1. Add a card account in Sure, as in Step 2.
  2. In WalletFeed, delete the key in API Key.
  3. Paste the key in API Key again.
  4. Make sure that WalletFeed shows Account.

If WalletFeed shows "Key rejected (HTTP 401)"

When Sure does not accept the key, WalletFeed shows "Key rejected (HTTP 401). Use a Read/Write key." The key is incorrect or expired, or you clicked Revoke for the key in Sure.

  1. Make sure that you copied the key with Copy API Key, and not the curl example.
  2. If you copied the curl example, do the steps in If you closed the key page before you copied the key.
  3. If you copied the key with Copy API Key, make a new Read/Write key in Sure, as in Step 3. While the previous key is active, the new key must have a different name, for example WalletFeed 2.
  4. In WalletFeed, paste the new key in API Key.

If Destinations shows "Authentication failed" for Sure

Sure does not accept the key when WalletFeed sends transactions. For example, this occurs if the key is Read Only, or if you clicked Revoke for the key in Sure.

  1. In WalletFeed, tap Destinations.

    The Destinations screen, where one destination shows Authentication failed.

  2. Tap the Sure destination.

  3. Replace the key, as in Replace the key.

If WalletFeed shows "Can't connect" or "Couldn't connect"

WalletFeed cannot connect to your Sure server. The server does not operate, or your iPhone can connect to it only on your home network.

  1. Make sure that your Sure server operates.
  2. Disconnect your iPhone from your home Wi-Fi.
  3. On your iPhone, open the https:// address of your Sure server in Safari.
  4. If Sure does not open, get an https:// address for all locations, as in Step 1.
  5. If you added Sure in WalletFeed, tap Send Test in the Sure destination.

The test writes a transaction of $4.20 with the name WalletFeed to the card account in Sure. You can delete the test transaction in Sure.

If WalletFeed shows "No Sure API at this address"

When the address is not correct, WalletFeed shows "No Sure API at this address, or the account is gone." If you deleted the card account, WalletFeed also shows this message when you replace the key.

  1. Make sure that the address is the same address that you use to open Sure in a web browser.
  2. If you deleted the card account in Sure, add a new card account, as in Step 2.
  3. If you added a new card account, add Sure again in WalletFeed, as in Step 4.

If you closed the key page before you copied the key

Sure shows a key one time only. Sure also does not accept two active keys with the same name.

  1. On your computer, open Settings › API Keys in Sure.
  2. Click Revoke for the WalletFeed key.
  3. Click Confirm.
  4. Make a new Read/Write key in Sure, as in Step 3.
  5. In WalletFeed, paste the new key in API Key.

If the card balance in Sure is not correct

Sure calculates the balance from the balance in Balance on date: and from the transactions. If Sure receives many transactions in a short time, Sure can show a balance without the last transaction.

  1. In Sure, open the card account.

  2. On the right side of the account name, click the icon with two arrows in a circle. Sure calculates the card balance again.

    The Apple Card account in Sure, with the icon of two arrows in a circle highlighted.

Updated October 30, 2026