Skip to main content

Sandbox Environment

Etherfuse provides a sandbox environment for testing your integration before going to production. The sandbox connects to testnets for all supported blockchains:
  • Stellar: Testnet
  • Solana: Devnet
  • Other supported chains: Testnet
This allows you to test the complete onramp, offramp, and swap flows without using real money or tokens.

Sandbox API URL

All sandbox API requests should be made to:
https://api.sand.etherfuse.com
Use the same API endpoints and authentication as production, just with the sandbox base URL.

Getting Sandbox Access

Getting started with the sandbox is self-service:
  1. Sign up at devnet.etherfuse.com
  2. Complete the KYC and bank account flows using fake data (no real information required)
  3. Test the complete onramp, offramp, and swap flows
API Key Required for API FlowsIf you want to test API-driven flows (rather than the UI), you’ll need an API key. Contact Etherfuse to request one, as API key creation must be enabled for your account.

Sandbox KYC & Bank Accounts

The sandbox environment accepts fake data for both KYC verification and bank account linking. You can submit any test identity information, documents, and bank details to complete the onboarding flow without providing real personal data.
Optional: Test with a real bank accountIf you want to verify that a real Mexican bank account can be correctly wired up with our SPEI provider, you can optionally link your real bank account in sandbox. No real funds will be moved or charged — all transactions in sandbox are simulated, even when using a real bank account. This is entirely optional — fake bank details work for standard testing.

Sandbox UI

A sandbox version of the Etherfuse UI is available at:
https://devnet.etherfuse.com
Use this to manage your sandbox account, complete KYC, link bank accounts, and monitor orders during testing.

Testnet Tokens

You’ll need testnet tokens to test offramps and swaps. Contact Etherfuse for information on obtaining testnet CETES, USDC, and other supported tokens on the relevant testnets.

Webhooks in Sandbox

Webhooks work the same in sandbox as in production. Make sure your webhook endpoint is publicly accessible (or use a tool like ngrok for local development) and register it via POST /ramp/webhook.