Sandbox Environment Overview
Sandbox Environment is an independent testing environment provided by SUNBAY for developers, used for development debugging and feature verification. All operations performed in the sandbox environment are simulated and will not generate real fund flows.
What is Sandbox Environment
Sandbox environment is a testing environment completely isolated from production environment, with the following characteristics:
- Independent Test Parameters - Uses dedicated Test App ID, Test Merchant ID, and test keys
- Simulated Transactions - All transactions are simulated, no real fund flows
- Complete Functionality - Supports all APIs and features of production environment
- Security Isolation - Completely isolated from production environment, no mutual impact
Sandbox vs Production Environment
| Comparison Item | Sandbox Environment | Production Environment |
|---|---|---|
| Purpose | Development testing, feature verification | Real business transactions |
| Fund Flow | Simulated transactions, no real funds | Real fund flows |
| Test Parameters | Test App ID, test keys | Production App ID, production keys |
| API Address | UAT API Base URL | Production API Base URL |
| Transaction Limits | No limits, can test freely | Subject to business rules and risk control limits |
| Data Retention | Periodically cleaned | Permanently retained |
Strictly Prohibited to Mix Parameters!
Sandbox environment and production environment parameters cannot be mixed. Using wrong parameters will cause transaction failures, security risks, and data confusion. Please clearly distinguish environment configurations in code.
Quick Start
1. Obtain Sandbox Parameters
After creating an application in Copilot portal, the system will automatically generate sandbox environment parameters (Test App ID, Test Merchant ID, test keys, etc.).
For detailed steps, please refer to Pre-Development Preparation.
2. Configuration and Testing
Configure sandbox parameters into your code, then execute various scenario tests. For detailed test scenarios and amount descriptions, please refer to Test Scenarios.
Sandbox Environment Limitations
Functional Limitations
- ✅ Supports all API interfaces and transaction types
- ✅ Supports Webhook notifications
- ❌ Does not generate real fund flows
- ❌ Does not support real bank card transactions
Data Limitations
- Test data will be periodically cleaned (usually retained for 30 days)
- Data persistence not guaranteed
Performance Limitations
- API call frequency limit: 100 times/minute
- Single merchant concurrent transactions: 10 transactions
- Exceeding limits will return S04 error (interface call frequency exceeded)
Production environment limits will be adjusted based on your business scale and contract agreement.
Switching to Production Environment
After testing is complete, need to update configuration parameters, rebind devices (semi-integrated payment), and execute production environment verification.
For detailed steps, please refer to Production Environment Preparation.