Essentials

Environments

Sandbox and Production environments

Volt provides two environments for development and live operations.

Overview

EnvironmentPurposeData
SandboxDevelopment & testingTest data only
ProductionLive paymentsReal money

URLs

ServiceSandboxProduction
APIhttps://api.sandbox.volt.iohttps://api.volt.io
OAuthhttps://api.sandbox.volt.io/oauthhttps://api.volt.io/oauth
FuzeboxToggle in top-right cornerToggle in top-right corner

Switching environments

In Fuzebox

Use the toggle in the top-right corner of Fuzebox to switch between Sandbox and Production.

Environment toggle

In your code

Use environment variables to manage URLs:

const API_URL = process.env.VOLT_ENV === 'production' 
  ? 'https://api.volt.io'
  : 'https://api.sandbox.volt.io';

Credentials

Separate credentials for each environment. Sandbox credentials won't work in Production and vice versa. Generate credentials separately for each environment in Fuzebox.

Testing in Sandbox

Sandbox provides:

  • Simulated banks - Test flows without real bank connections
  • Test scenarios - Simulate success, failure, and edge cases
  • No real money - Safe to experiment

Going live checklist

Before switching to Production:

All flows tested in Sandbox

Error handling implemented

Webhooks configured and tested

Production credentials generated

API URLs updated to Production

Monitoring and logging in place

Environment parity

Keep your Sandbox and Production configurations as similar as possible:

  • Same webhook URLs structure
  • Same error handling
  • Same timeout settings
  • Same retry logic

How is this guide?

Last updated on

On this page