Skip to content

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

  1. 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.)
  2. Click Create an API token.
  3. Nickname: WarpExit (read only).
  4. Permissions: choose Read Only. Leave the IP allowlist empty; read-only tokens don't need one.
  5. Click Create token and copy it. It starts with secret-token:mercury_production_. Mercury shows it only once.
  6. 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.