A. Creating a New Sandbox
This flow allows an admin to create a new, isolated sandbox environment.
Step 1: Log in to your production provider account (or Super Admin account) and navigate to the Sandbox section in the provider menu.
For System admins there is a second section System / Sandbox to create/maintain sandboxes on behalf of a provider. Here you can also create a sandbox for a prospect or partner that doesn’t need access to a live production provider.
Sandbox users can manage many features, like 'Look & Feel' and 'Product Selection,' directly from their 'Sandbox Settings' page. For more advanced configurations not available in that menu, our Support and CSM teams have full system admin access, similar to a production environment.
Step 2: You will see an overview of all existing sandboxes. Click the "+ New Sandbox" button.
Step 3: A "New Sandbox" modal will appear. Fill in the required details:
Name: A clear, descriptive name (e.g., "API Integration Test").
Description: A brief explanation of the sandbox's purpose.
Product Modules: Select the services you need to test:
MSP: Mobility ServicesCPO: Charge Point OperationsBoth MSP & CPO
Sandbox Data: Choose the initial data state:
Blank (No data): A completely empty environment.Preconfigured test data: Populated with dummy data for immediate use.
Live Provider: Link this sandbox to a specific provider. → ONLY available to system admins.
Parent Sandbox: (Optional) Link to another sandbox.
Step 4: Click "Create". The new sandbox will be provisioned and will appear in your sandbox list. It will have a unique, automatically generated 'provider-slug' (e.g.,
sandbox-a34g56).
B. Accessing and Using a Sandbox
Step 1: From the Sandbox list in your provider account, click the blue link (the sandbox name).
Step 2: You will be redirected to the sandbox's unique login URL. Users from the parent production account are automatically granted access.
Step 3: Upon logging in, you will see a blue "Sandbox mode" banner at the top of the screen, confirming you are in a safe test environment.
Step 4: The sandbox dashboard provides quick links to key developer and configuration areas.
Sandbox Settings: Configure the look, feel, and features of this specific sandbox.
API Credentials: Start your integration with pre-created API keys.
API Documentation: Explore our APIs.
Charge Station Simulator: Run a virtual charging station in your browser to test CPO flows.
C. Managing Existing Sandboxes
Step 1: Navigate back to the Sandbox section in your production provider account.
Step 2: In the sandbox list, use the "Actions" column:
Click the edit icon to edit the Name and Description of a sandbox.
Click the trash icon to permanently delete a sandbox.
Step 3: If deleting, you must confirm the action. This will permanently delete the sandbox and all its related data. This action cannot be undone.
Configuration/Settings
Once inside a sandbox, you can configure its specific settings to match your testing needs. Navigate to Sandbox > Settings from the dashboard.
Key settings you can configure include:
Look & Feel:
Upload a custom logo (for light and dark modes).
Upload a favicon.
Customize primary and secondary colors (for light and dark modes).
You can choose to disable the "Sandbox mode" banner (e.g., for demos).
Product Selection:
Toggle which product modules (MSP, CPO) are visible in the menus.
Platform Access:
Enable platform self-sign-up for new users.
Support & Maintenance: add your company (support )details
Charge Stations: enable features like advanced tariffs, charge station bulk operations, custom fees, wtc.
Charge Cards: enable features like MSP limits, or MSP fees
Billing: Enable invoicing
Roaming: Configure sub-operator settings.
Example Use Cases
Use Case 1: Testing an API Integration
Scenario: A developer needs to build an integration to start/stop charge sessions via API.
Solution: The Provider Admin creates a
Blank (No data)sandbox and selectsCPO. The developer logs into the sandbox, gets credentials from the "API Credentials" page, and uses the "Charge Station Simulator" to test their API calls successfully.
Use Case 2: Training New Staff
Scenario: A new support agent needs to learn the platform without "breaking" anything.
Solution: The manager creates a sandbox using
Preconfigured test data. The new agent can log in and practice creating users, issuing charge cards, and handling simulated billing issues in a realistic but safe environment.
Use Case 3: Prospect Demonstration
Scenario: A sales employee needs to show a major prospect the full capabilities of the platform, branded with the prospect's logo.
Solution: The sales employee (as a Super Admin) creates a new sandbox, selects
Both MSP & CPO, and accesses the "Sandbox Settings" to upload the prospect's logo and configure their brand colours.
Limitations/Considerations
Data Isolation: All data is strictly isolated. Sandbox data will never be synced to production, and production data (other than user access) is not synced to the sandbox.
No Production Sync: Integrations with production third-party systems (like NetSuite or live roaming networks) are permanently disabled in the sandbox.
No Trial Management: This feature is for testing and demos, not for managing timed customer trials or automatic conversion to production accounts.
Reporting Exclusion: Data generated within sandboxes is excluded from all official business and financial reporting.
FAQ
Q: Will actions in a sandbox affect my real customers or chargers? A: No. A sandbox is 100% isolated. All data, transactions, and configurations are separate from your production environment and will never impact your live customers.
Q: How do I log into my sandbox? A: Each sandbox has its own unique login URL. You can find this link on the "Sandbox" overview page in your production account. Your existing production user credentials will automatically work to log you in.
Q: Can I copy my production environment into a sandbox? A: You cannot copy your live production data. However, you can create a sandbox with Blank (No data), Preconfigured test data, or Copy data from an existing sandbox (if you have one).
Q: How do I get API keys for my sandbox? A: Once you log into your sandbox, navigate to the "Developers" section. You will find pre-created API credentials, quickstart guides, and documentation ready to use.