Hi all — I’m building a Wallet-style transaction details view using FinanceKit and I’m running into a gap around merchant location.
What I’m seeing
FinanceKit gives me great core fields (amount, currency, status, dates, MCC, merchantName, transactionDescription), but I’m not seeing any address or place/location metadata on a Transaction.
For example, a small/local merchant where I can plausibly infer a single place:
Fetched transaction:
Transaction(
id: 8D142B16-3E0E-40B8-945A-2E7C0CF65F1D,
accountID: 14939CF4-DBC3-4A9D-8292-5FEA495B8461,
transactionAmount: 47.24 USD,
creditDebitIndicator: .debit,
transactionDescription: "Local Dental Care",
originalTransactionDescription: "Local Dental Care",
merchantCategoryCode: 8021,
merchantName: "Local Dental Care",
transactionType: .pointOfSale,
status: .booked,
transactionDate: 2025-08-20 22:27:50 +0000,
postedDate: 2025-08-21 11:22:06 +0000
)
Because this appears to be a single-location practice, I can usually resolve it to a place using MapKit search heuristics.
But for big-box chains, I don’t get enough signal to determine which store:
Fetched transaction:
Transaction(
id: 3F8E9F74-7565-4D24-9038-8FD709184799,
accountID: 14939CF4-DBC3-4A9D-8292-5FEA495B8461,
transactionAmount: 441.77 USD,
creditDebitIndicator: .debit,
transactionDescription: "The Home Depot",
originalTransactionDescription: "The Home Depot",
merchantCategoryCode: 5200,
merchantName: "The Home Depot",
transactionType: .pointOfSale,
status: .booked,
transactionDate: 2023-12-27 23:07:02 +0000,
postedDate: 2023-12-29 03:09:41 +0000
)
There’s no store number, address, phone, or any stable identifier. With hundreds of locations, I can’t deterministically choose a map pin or fetch the right brand assets.
What I’m trying to achieve
I’d like to replicate the Apple Wallet experience: show a small map snapshot and merchant visuals (logo/name that match Apple Maps / the Place Card) on the transaction detail screen. Without a location hint, I have to either:
Ask users to pick a store manually, or
Make a guess based on a coarse, app-defined region
…neither of which feels great.
Questions
Is there any way in FinanceKit today to access merchant location or a resolvable identifier (e.g., address, city/state, store number, Apple Maps place identifier, network merchant ID/MID, terminal ID, etc.)?
If not, can FinanceKit expose additional merchant metadata (even opt-in / privacy-preserving) to enable Wallet-like enrichment? A few examples that would unblock this:
merchantAddress (or components: street/city/region/postalCode/country)
merchantPhone (often unique per store)
merchantIdentifier (stable per physical location, e.g., network merchant ID / store number)
mapsPlaceURL or mapsPlaceIdentifier (linkage to the Apple Maps Place Card)
brandAssetURL (logo/brand reference similar to what Wallet shows)
With even one of the above, I could reliably:
Render an accurate map snapshot,
Fetch the correct brand assets, and
Avoid prompting the user or inferring via fuzzy search.
Context / constraints
I do not want to (and shouldn’t need to) request or monitor the user’s device location to resolve a merchant’s store location.
For small merchants, MapKit text search is often enough. For large chains, I need a store-level identifier.
If there’s an existing field or recommended approach I’m missing, I’d love pointers. If not, please consider this a feature request for richer merchant metadata in FinanceKit so developers can build Wallet-quality transaction details.
Thanks!
