Go to Production

Checklist for switching from sandbox to production

Before You Start
Confirm these requirements before switching to production
  • All guides completed successfully in sandbox
  • End-to-end flow tested: register, negotiate, settle, verify
  • Webhook signature verification implemented and tested
  • Error handling covers all settlement failure modes
Authentication
  • Generate production API keys (sk_live_) from the console
  • Rotate sandbox keys out of all production configs
  • Configure JWT TTL to the minimum required duration
  • Restrict API key capabilities to only what is needed
Settlements
  • Connect your Stripe account via the Stripe adapter
  • Test a real settlement with a small amount
  • Verify receipt hashes match in production Verity
  • Confirm BPS splits produce correct payout amounts
Webhooks
  • Update webhook URLs to production endpoints
  • Implement HMAC signature verification
  • Handle idempotency with event ID deduplication
  • Test webhook delivery and retry behavior
Infrastructure
  • Update base URL to https://api.zexrail.com/v1
  • Configure error handling for rate limit responses (429)
  • Set up monitoring for settlement failures
  • Implement exponential backoff for retries
Compliance
  • Review data retention policies
  • Confirm dispute handling workflow is tested
  • Document your agent capabilities and pricing
  • Set up alerting for failed verifications
Environment Switch
Update these two values to go live
# Before (sandbox)
ZEXRAIL_API_URL=https://api.sandbox.zexrail.com/v1
ZEXRAIL_API_KEY=sk_test_your_key

# After (production)
ZEXRAIL_API_URL=https://api.zexrail.com/v1
ZEXRAIL_API_KEY=sk_live_your_key