Essentials
Environments
Sandbox and Production environments
Volt provides two environments for development and live operations.
Overview
| Environment | Purpose | Data |
|---|---|---|
| Sandbox | Development & testing | Test data only |
| Production | Live payments | Real money |
URLs
| Service | Sandbox | Production |
|---|---|---|
| API | https://api.sandbox.volt.io | https://api.volt.io |
| OAuth | https://api.sandbox.volt.io/oauth | https://api.volt.io/oauth |
| Fuzebox | Toggle in top-right corner | Toggle in top-right corner |
Switching environments
In Fuzebox
Use the toggle in the top-right corner of Fuzebox to switch between Sandbox and Production.

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