Testing & Sandbox

The Heron Sandbox is a fully isolated environment that allows you to build and test your integration without moving real funds. It mirrors the production environment's functionality, including compliance checks and payment rail validations.

Sandbox Environment

Use the following base URL for all Sandbox requests:

https://dev.api.tryheron.com/v1

Test API Keys

Sandbox requests use specific Test API Keys. You can generate these in the Heron Dashboard by toggling to Test Mode.

TIP

Test API Keys usually start with sk_test_ to help you distinguish them from Production keys (sk_live_).

Going Live

When you're ready to move to production:

1. Complete your Business Verification (KYB) in the dashboard.
2. Toggle the dashboard to Live Mode.
3. Generate a Production API Key.
4. Update your base URL to https://api.tryheron.com/v1.