Environments
Understand sandbox vs production and the X-Environment header.
Environments
VanityPass operates two isolated environments: Sandbox for development and testing, and Production for live transactions.
Sandbox
The sandbox environment is a complete replica of the production system where you can:
- Test all API endpoints without real charges
- Create test bookings and reservations
- Verify workflow integration
- Experiment with error handling
Endpoint: https://cloud.vanitypass.com
Header: X-Environment: Sandbox
Use sandbox API keys (vp_test_*) to authenticate. These keys are valid only in the sandbox environment.
Production
Production is the live environment where real transactions occur and real charges are applied.
Endpoint: https://cloud.vanitypass.com (same domain, different schema)
Header: X-Environment: Production
Use production API keys (vp_live_*) to authenticate. Production access requires approval and signed contract.
Playground Policy
This documentation site's interactive "Try it" playground is sandbox-only. Every request is automatically routed to:
https://cloud.vanitypass.com
X-Environment: Sandbox
To test against production or to get production API keys, contact the sales team.
Header Examples
Sandbox request
GET /v1/fx/rates
Host: cloud.vanitypass.com
X-Api-Key: vp_test_abc123
X-Environment: Sandbox
Production request
GET /v1/fx/rates
Host: cloud.vanitypass.com
X-Api-Key: vp_live_xyz789
X-Environment: Production
Omitting the X-Environment header defaults to Production.