Environments
Sandbox and production URLs for API, CDN, and Merchant Dashboard.
Bolt provides separate sandbox and production environments. Each has its own Merchant Dashboard, API keys, and divisions.
URLs
| Type | Sandbox | Production |
|---|---|---|
| API | https://api-sandbox.boltapp.com | https://api.boltapp.com |
| CDN (Connect) | https://connect-sandbox.boltapp.com | https://connect.boltapp.com |
| Merchant dashboard | merchant-sandbox.boltapp.com | merchant.boltapp.com |
| Shopper dashboard | account-sandbox.boltapp.com | account.boltapp.com |
All transactions that flow through Bolt checkout appear in the Merchant Dashboard for the matching environment.
Configure environment variables
Set BOLT_ENV and derive the API base URL in your application:
# Sandbox
BOLT_ENV=sandbox
BOLT_API_BASE_URL=https://api-sandbox.boltapp.com
# Production
# BOLT_ENV=production
# BOLT_API_BASE_URL=https://api.boltapp.comSandbox and production keys are separate. Never point https://api.boltapp.com at sandbox credentials or https://api-sandbox.boltapp.com at production credentials.
Divisions
A merchant account can have one or many divisions: separately configured checkout instances (e.g. storefront vs back office). Each division has its own publishable key and webhook URLs.
Common divisions include Pay by Link and Back Office.
Collaborating with many developers across multiple sandboxes does not require multiple divisions. Add each URL to your Trusted Domains list.
Account types
Merchant account types are tied to payment processors. Switching processors requires a new Bolt merchant account aligned with the new processor.