Sandbox Environment
The BillHive sandbox environment allows you to test your integration without affecting live data or processing real payments.
Overview
The sandbox is a fully functional replica of the production environment. Use it to test API calls, webhook integrations, and payment flows before going live.
Getting Started
- Sign up for a sandbox account at the BillHive dashboard.
- Obtain your sandbox API keys from Settings > API Keys.
- Use the sandbox base URL for all API requests.
Sandbox vs Production
| Feature | Sandbox | Production |
|---|---|---|
| Base URL | https://sandbox.billhive.org/api | https://api.billhive.org |
| Payments | Simulated | Real |
| Data | Test data only | Live data |
| Webhooks | Supported | Supported |
Test Data
The sandbox environment comes pre-loaded with test data including sample customers, subscriptions, and invoices. You can also create your own test data through the API or dashboard.
Test Payment Methods
Use the following test credentials to simulate payment scenarios in the sandbox:
- Successful Payment: Use test card number
4111 1111 1111 1111 - Failed Payment: Use test card number
4000 0000 0000 0002 - 3D Secure: Use test card number
4000 0000 0000 3220
Limitations
- Sandbox data is periodically reset.
- Email notifications are not sent from the sandbox environment.
- Rate limits may differ from production.