From 61d200f4e69d05b468debc8adf6d2224dce43832 Mon Sep 17 00:00:00 2001 From: xBlaz3kx Date: Sun, 2 Aug 2026 18:47:31 +0200 Subject: [PATCH 1/2] 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. From 83ff22dbae49b36104006f112f128d9630cfdda8 Mon Sep 17 00:00:00 2001 From: xBlaz3kx Date: Wed, 12 Aug 2026 19:24:13 +0200 Subject: [PATCH 2/2] docs: address Wise provider review comments --- providers/wise.mdx | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/providers/wise.mdx b/providers/wise.mdx index 6699806..c90e5ef 100644 --- a/providers/wise.mdx +++ b/providers/wise.mdx @@ -16,15 +16,15 @@ Wise integration connects your Wise multi-currency account to Sure using a perso ## 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 +1. Sign in to your Wise business account at [wise.com](https://wise.com) (personal API tokens are issued from business account settings, even if you're only connecting a personal profile) +2. Go to **Your Account → Connect and manage apps → API tokens** (requires two-factor authentication on the account) +3. Create a new personal API token and choose an access level: **read only** lets Sure read balances, transfers, and Jar activity; **full** additionally allows the token to authorize recipients and transfers, so prefer read-only unless you need that capability elsewhere 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`). +For testing, Wise provides a sandbox environment at `https://api.wise-sandbox.com` (the V2 sandbox host; the legacy `api.sandbox.transferwise.tech` URL was retired). Set `WISE_BASE_URL` in your Sure environment to point at it instead of the default live API (`https://api.wise.com`). ## Features @@ -37,8 +37,8 @@ For testing, Wise provides a sandbox environment at `https://api.sandbox.transfe ### 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 +- 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. Statement-based history is only available for Wise accounts registered in a country the Wise API supports for statement retrieval (currently the US, Canada, Australia, New Zealand, Singapore, and Malaysia) — other accounts sync balances and Jar activity but won't get transfer history +- Transfers are matched to their linked balance by Wise balance ID, so Jars that share the same currency are still tracked as separate accounts - 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 @@ -60,7 +60,7 @@ If your Wise account has both personal and business profiles, you can connect se ## 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. +**Invalid token / connection requires update**: your API token was revoked, is invalid, or lacks permissions (Wise personal API tokens don't expire on their own). 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.