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