Skip to main content
Henry provides parallel sandbox and production environments so you can build confidently before you ship to real buyers. Follow the steps below to configure keys, test critical flows, and complete the production launch checklist.

​
Understand environments

EnvironmentBase URLUsage
Sandboxhttps://api.sandbox.henrylabs.ai/v0Development and QA. Mirrors production data models and supports test card numbers.
Productionhttps://api.henrylabs.ai/v0Live traffic. Handles real shoppers, merchants, and payments.
Sandbox requests require sandbox API keys. Production requests require production keys and operate on live data. Keys are not interchangeable across environments.

​
1. Configure credentials

1

Create sandbox API key

Generate a key from the Henry Sandbox Dashboard. Scope it to the services you plan to test.
2

Set up user tokens

Endpoints that manage user state or checkout sessions require both an x-api-key along with a stable x-user-id.
3

Request production access

When you’re ready to go live, contact your Henry representative or email lawrence@henry.social for production credentials. Rotate the values in your secrets manager without redeploying code.

​
2. Exercise core scenarios

Run through the flows below using sandbox credentials before you promote:
  • Product discovery: /products/search and /products/details with realistic queries to confirm facets and filters.
  • Cart lifecycle: /cart/add-items, /cart/get-items, and /cart/delete-single-item to verify quantities, pricing, and merchant eligibility.
  • Hosted checkout: Launch /cart/initiate-checkout in an iframe or redirect and complete a mock purchase. Inspect the resulting order with /orders/order-status.
  • Headless checkout (optional): Use /checkout/session/quote and /checkout/single with both x-api-key.
  • Wallet card collection: Call /wallet/card-collect to ensure your UI can launch the modal and receive the modal_url.
  • Merchant data: Fetch /merchants/list and /merchants/shipping-info to preload brand-specific settings.
Document each request and response so you can compare sandbox versus production during rollout.

​
3. Validate error handling

Henry Shopping APIs share a common envelope: { "success": boolean, "status": string, "message": string, "data": { ... } }. Confirm your integration logs the status and message values and gracefully reacts to these scenarios: Simulating failures in the sandbox now makes it easier to debug production incidents later.

​
4. Promote to production

  1. Swap the base URL to https://api.henrylabs.ai/v0.
  2. Rotate to production x-api-key.
  3. Replay the smoke tests above with a small allowlisted merchant and shopper cohort.
  4. Monitor orders in real time with /orders/order-status.
Need help validating your integration? Contact support and we’ll review your sandbox results.