Environments
Smartbills provides two distinct environments to help you develop and test your integration before going live.Available Environments
Production Environment
The production environment is where your live application runs and processes real transactions. Base URL:https://api.smartbills.io
Production API keys are only enabled once your application has been approved by our team.
Pre-Production (Sandbox) Environment
The pre-production environment is a safe space to develop and test your integration without affecting real data. Base URL:https://sandbox-api.smartbills.io
All developer accounts have immediate access to the pre-production environment.
Key Differences
Using Different Environments
You can switch between environments by changing the base URL in your API requests:Best Practices
Use Environment Variables
Use Environment Variables
Store your API keys and base URLs as environment variables to easily switch between environments.
Test Thoroughly in Pre-Production
Test Thoroughly in Pre-Production
Always test your integration thoroughly in the pre-production environment before deploying to production.
- Test all API endpoints
- Verify error handling
- Test webhook delivery
- Validate data formats
Keep Separate API Keys
Keep Separate API Keys
Use different API keys for each environment and never use production keys in development.
Monitor Both Environments
Monitor Both Environments
Set up monitoring and logging for both environments to catch issues early.
Getting Access
Pre-Production Access
- Create a Smartbills account at smartbills.io
- Visit the developer portal
- Create a new application
- Your pre-production API keys will be generated immediately
Production Access
- Complete your integration in pre-production
- Submit your application for review
- Our team will review your integration
- Once approved, your production API keys will be activated
Data Isolation
Data between environments is completely isolated:- Users created in pre-production do not exist in production
- Receipts and transactions are environment-specific
- Webhooks are sent to different endpoints per environment