From 61d200f4e69d05b468debc8adf6d2224dce43832 Mon Sep 17 00:00:00 2001 From: xBlaz3kx Date: Sun, 2 Aug 2026 18:47:31 +0200 Subject: [PATCH] docs: add Wise provider integration guide --- docs.json | 1 + providers/overview.mdx | 8 +++++ providers/wise.mdx | 67 ++++++++++++++++++++++++++++++++++++++++++ 3 files changed, 76 insertions(+) create mode 100644 providers/wise.mdx diff --git a/docs.json b/docs.json index 72f2464..4338e53 100644 --- a/docs.json +++ b/docs.json @@ -69,6 +69,7 @@ "providers/binance", "providers/enable-banking", "providers/lunchflow", + "providers/wise", "providers/simplefin", "providers/plaid", "providers/redbark", diff --git a/providers/overview.mdx b/providers/overview.mdx index b00c88d..2b448fe 100644 --- a/providers/overview.mdx +++ b/providers/overview.mdx @@ -21,6 +21,14 @@ Available providers include Yahoo Finance, Twelve Data, Tiingo, EODHD, Alpha Van - **Pricing**: Paid service - **Documentation**: [Lunch Flow](/providers/lunchflow) +### Wise users + +**Wise** connects your Wise multi-currency account directly using a personal API token, syncing balances, Jars, and transfers. + +- **Best for**: Users who hold multiple currencies in a Wise account +- **Pricing**: Free (requires a Wise personal API token) +- **Documentation**: [Wise](/providers/wise) + ### European users **Enable Banking** is recommended for EU users. It provides free access to European banks through PSD2 open banking standards. diff --git a/providers/wise.mdx b/providers/wise.mdx new file mode 100644 index 0000000..6699806 --- /dev/null +++ b/providers/wise.mdx @@ -0,0 +1,67 @@ +--- +title: Wise +description: Connect your Wise multi-currency account using a personal API token +--- + +Wise integration connects your Wise multi-currency account to Sure using a personal API token. Sure syncs your currency balances, Jars (savings pots), transfers, and Wise Assets activity directly from the Wise API — no OAuth flow required. + +## How it works + +1. You create a personal API token in Wise and paste it into Sure +2. Sure fetches the profiles (personal and/or business) available to that token +3. You choose which profile(s) to connect — each becomes its own connection in Sure +4. Sure discovers every currency balance and Jar under the connected profile(s) +5. You link each discovered balance to a new or existing Sure account +6. Syncs then run automatically, pulling balances, transfers, and Jar activity + +## Setting up Wise + +1. Sign in to [wise.com](https://wise.com) +2. Go to **Settings → API tokens** +3. Create a new personal API token with read-only access +4. In Sure, go to **Settings > Providers**, find the **Wise** panel, and paste the token +5. If the token has access to more than one profile (for example, a personal and a business profile), select which ones to connect — Sure creates a separate connection for each +6. Open **Set Up Accounts** on the new connection and link each currency balance to a Sure account + + +For testing, Wise provides a sandbox environment at `https://api.sandbox.transferwise.tech`. Set `WISE_BASE_URL` in your Sure environment to point at it instead of the default live API (`https://api.wise.com`). + + +## Features + +### Multi-currency balances + +- **Standard balances**: one balance per currency held in your Wise account, refreshed (including reserved amount) on every sync +- **Jars (savings pots)**: synced alongside standard balances and mapped to a savings-type account in Sure +- New balances discovered on a sync are shown as "needs setup" until linked to a Sure account + +### Transaction syncing + +- The first sync imports 90 days of transfer history (or history from a sync start date you configure); later syncs use a 7-day lookback from the last successful sync +- Transfers are matched to each linked balance by source or target currency +- Cross-currency incoming transfers use the amount actually received, not the amount sent +- When a same-currency transfer includes a fee, the fee is imported as a separate "Wise fee" transaction + +### Jar activity + +- Deposits and withdrawals to a Jar are imported as "Transfer to Jar" / "Transfer from Jar" transactions +- Interest and Wise Assets fees are imported automatically +- Transfers between a standard balance and a Jar are automatically linked as Sure Transfers, so the same movement is never double-counted as separate income and expense + +### Multiple profiles + +If your Wise account has both personal and business profiles, you can connect several profiles from the same token at once. Each profile is a separate connection that can be synced, updated, or disconnected independently. + +## Limitations + +- Uses a Wise personal API token rather than OAuth; the token carries whatever account access you grant it in Wise +- Wise Assets (investment) balances are not tracked as accounts — only fees charged against them are imported +- Each discovered currency balance must be linked to a Sure account manually after the first sync; balances aren't created automatically + +## Troubleshooting + +**Invalid token / connection requires update**: your API token was revoked, expired, or lacks permissions. Create a new personal token in Wise and update it in the Wise provider panel. + +**No profiles found**: the token doesn't have access to any Wise profile. Check the token's permissions in Wise and try again. + +**A currency balance is missing**: run a sync, then check **Set Up Accounts** on the connection — new balances only become Sure accounts once you link them.