Sandbox Testing
Complete testing guidelines for validating your MasonHub integration
Comprehensive testing in the sandbox environment is essential before promoting your integration to production. This section outlines the testing approach and key scenarios to validate.
Important: All clients must complete sandbox testing before promoting their integration to production.
Testing Environment
Sandbox Access
- URL: https://sandbox.masonhub.co
- API Base:
https://sandbox-api.masonhub.co - Purpose: Safe testing environment with isolated data
Test Data Management
Use the Data Factory to generate realistic test data for production simulations including shipments, inbound shipment receipts, and more.
Core Testing Areas
1. SKU Synchronization Testing
2. Order Lifecycle Testing
Order Creation
Test various order scenarios:
- Single item orders
- Multi-item orders
- Orders with special handling requirements
- International orders with customs data
Ship Method Mapping
Validate all configured shipping methods:
- Standard ground shipping
- Express delivery options
- International shipping services
- Will-call pickups
VAS Tags
Test value-added services:
- Gift wrapping
- Custom packaging
- Special handling instructions
Backorder Handling
If applicable to your business:
- Partial inventory scenarios
- Backorder creation and tracking
- Backorder fulfillment workflows
3. Inbound Shipment Testing
4. Fulfillment Scenarios
Complete Fulfillment
Orders fulfilled exactly as requested
Split Fulfillment
Orders shipping in multiple packages
Short Fulfillment
Orders with insufficient inventory
5. Inventory Snapshot Testing
- Real-time Updates: Verify inventory changes reflect immediately
- Allocation Tracking: Test committed vs. available inventory
- Multi-location: If applicable, test inventory across multiple warehouses
Data Synchronization Testing
Polling Method Testing
Test periodic polling of:
- Order status updates
- Shipment tracking information
- Inventory level changes
- Inbound receipt confirmations
Webhook Testing
- Configure callback URLs
- Test webhook authentication
- Validate event payload formats
Use Data Factory for production simulations of shipments, inbound shipment receipts etc.