How to create a read-only Mercury API token
Two minutes in Mercury: create a Read Only API token so a buyer or a tool like WarpExit can see balances and transactions, and nothing can move money.
Published , 2 minute read
A Read Only token lets WarpExit see your Mercury balances and transactions. It cannot send money, add recipients or change anything. It takes about two minutes.
Steps
- Open Mercury's Tokens page and sign in as an admin. (Or click your company name at the top left, then All Settings, then Tokens under Developers.)
- Click Create an API token.
- Nickname:
WarpExit (read only). - Permissions: choose Read Only. Leave the IP allowlist empty; read-only tokens don't need one.
- Click Create token and copy it. It starts with
secret-token:mercury_production_. Mercury shows it only once. - In WarpExit, open your room's Bank step, paste the token, tick I created a Read Only token, and click Connect Mercury.
That's it. Balances and up to 24 months of transactions import in a few seconds, and your Stripe payouts get matched to deposits.
Good to know
- It needs to be used. Mercury deletes tokens that go unused for 45 days. WarpExit syncs daily, so yours stays alive while it's connected.
- Admin approval. On some Mercury accounts a second admin has to approve new tokens. If you can't see Create an API token, ask an admin, or use "Ask your developer or a teammate" in WarpExit to send them these steps.
- Turning it off. Disconnecting in WarpExit deletes our copy. Also delete the token in Mercury under Settings, Tokens.
- Not on Mercury? Upload bank statements (PDF or CSV) instead. WarpExit checks that the balances add up.
Keep reading
Related guides
- How to create a read-only Meta Ads tokenStep by step in Meta Business Settings: a system user token with only ads_read, so WarpExit can show ad spend and acquisition cost without being able to change or pay for ads. 4 minute read.
- Reconciling Stripe payouts with bank deposits before a saleHow to match Stripe payouts to bank deposits before selling a SaaS: payout timing, what gets netted out, failed payouts, and explaining unmatched items. 6 minute read.
- What to put in a data room when selling a SaaSThe folders, files and numbers buyers expect when you sell a small SaaS, what to hold back until LOI, and how to show where every number came from. 6 minute read.