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

To get access to the sandbox environment:
  1. Contact Etherfuse to request sandbox credentials
  2. You’ll receive a sandbox API key separate from your production key
  3. Use this key with the sandbox API URL for all test requests
Important: The sandbox environment still requires KYC verification and bank account setup, just like production. You have two options:
  • Full setup: Complete the KYC process and link bank accounts in the sandbox environment to test the complete flow
  • Whitelisted access: Contact Etherfuse to get your test account whitelisted, which allows you to skip certain verification steps for faster 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.

​
Testing Onramps

In production, onramp orders require the customer to send MXN to a deposit CLABE. In the sandbox, you can simulate this deposit using the /ramp/order/fiat_received endpoint. Sandbox onramp flow:
  1. Create an onramp order via POST /ramp/order
  2. Note the orderId from the response
  3. Call POST /ramp/order/fiat_received with the orderId to simulate the fiat deposit
  4. The order will automatically progress through funded → completed status
  5. Monitor progress via webhooks or by polling the order status
Example fiat_received request: 
POST https://api.sand.etherfuse.com/ramp/order/fiat_received

{
  "orderId": "123e4567-e89b-12d3-a456-426614174000"
}

​
Testing Offramps

Offramp testing works the same as production:
  1. Create an offramp order via POST /ramp/order
  2. Receive the burnTransaction in the order_updated webhook
  3. Sign and submit the transaction to the testnet/devnet blockchain
  4. The order will progress to funded once the transaction is confirmed
  5. The sandbox will simulate the fiat payout, and the order will complete

​
Testing Swaps

Swap testing also works the same as production:
  1. Create a quote via POST /ramp/quote with type: "swap"
  2. Create a swap via POST /ramp/swap
  3. Receive the sendTransaction in the swap_updated webhook
  4. Sign and submit the transaction to the testnet blockchain
  5. The swap will complete and you’ll receive a swap_updated webhook with status completed

​
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.