Environments
Magnolia Financial provides two environments for building and testing your integration.
Available Environments
| Environment | Base URL | Purpose |
|---|---|---|
| Production | https://api.magfi.net | Live environment with real Bitcoin mainnet and fiat transactions |
| Sandbox | https://api.sandbox.magfi.dev | Testing environment with Bitcoin testnet (regtest) |
Choosing an Environment
Use Sandbox When:
- 🧪 Developing your integration - Test API calls without real money
- 🔍 Testing edge cases - Use sandbox-only endpoints to simulate scenarios
- 📚 Learning the API - Experiment freely without consequences
- ✅ Running automated tests - Safe environment for CI/CD pipelines
Use Production When:
- 💰 Processing real transactions - Live Bitcoin and fiat operations
- 👥 Serving real users - Production-ready applications
- 📊 Operating at scale - Full performance and reliability
Sandbox Environment Details
The sandbox environment is designed to mirror production as closely as possible, with the following key differences:
1. Bitcoin Network
| Aspect | Sandbox | Production |
|---|---|---|
| Network | Bitcoin regtest (MagFi-controlled) | Bitcoin mainnet |
| Confirmations | Fast (controlled by MagFi) | Real blockchain timing (~10 min/block) |
| Funds | Test Bitcoin (no real value) | Real Bitcoin with monetary value |
2. Fiat Transactions
| Aspect | Sandbox | Production |
|---|---|---|
| Fiat transfers | Mocked bank transfers | Real bank integrations |
| Processing | Instant (simulated) | Real-world timing (hours to days) |
| Funds | Simulated amounts | Real fiat currency |
3. External Services
Nearly all external service integrations are mocked in sandbox:
- Bank transfers
- Identity verification
- Compliance checks
Data Isolation
Data in sandbox and production environments is completely isolated:
- Accounts created in sandbox are not visible in production
- API keys are environment-specific
- No data is shared between environments
This ensures safe testing without affecting production data.
Rate Limits
Both environments have the same rate limits:
- 1000 requests per minute (default)
See the Rate Limits page for details.
Support and Troubleshooting
If you encounter environment-specific issues:
- Verify your base URL is correct for the intended environment
- Check your API key matches the environment
- Review sandbox limitations for mocked external services
- Check endpoint availability using the environment switcher in the docs