Skip to main content
Bridge has two separate environments. They don’t share data, keys, or webhooks.

How the sandbox behaves

The sandbox checks your requests exactly like live does. A request that fails in the sandbox fails in live too. The difference is what happens after a payment is created:
  • No bank, mobile money provider, or blockchain is contacted.
  • The deposit instructions you get back are for testing only. Don’t send real money to them.
  • The payment walks through the happy path by itself, one step about every 3 seconds, until it reaches completed.
  • You receive a webhook at each step, just like in live.
  • One-time codes for mobile money are checked for format (4 to 8 digits) but not sent anywhere.
Use the sandbox to make sure your app handles every webhook and every error before you go live.

Using the wrong key

Keys only work in their own environment. If you mix them up, you get a 401 error that tells you what went wrong:

Going live checklist

1

Create a live API key

In the live Bridge app, create a key that starts with bridge_live_. See Create API keys.
2

Allowlist your live servers

Add your production servers’ IP addresses in the live Bridge app. See Allowlist your IP addresses.
3

Add your live webhook

Add your production webhook URL and save its new signing secret. See Set up webhooks.
4

Check your currency pairs

Make sure the pairs you need are turned on for your live business. See Currency pairs.
5

Change the base URL

Point your app at https://core.linkio.world/api.
Last modified on October 29, 2026