Troubleshooting

Common messages and fixes.

Message or symptomFix
Current reviewed intake policy is unavailableSet MEDSPA_INTAKE_MAX_AGE_DAYS
Required intake template changed after the clinical order was issuedRe-collect intake on the current template version
Appointment version changed; review the current stateReload and retry
Controlled checkout currently supports operator-recorded cash onlyRecord the payment as cash
Clinical services require a completed authorized consultation before checkoutComplete the treatment workspace
Idempotency key was already used for another ...Use a new key for different details
App fails at startupAll five S3_* variables are required
Storefront shows nothingPublish storefront settings; set MEDSPA_PRACTICE_SLUG if several practices are published
Stripe webhook rejectedSet STRIPE_WEBHOOK_SECRET; the route needs the raw body and stripe-signature
AI chat has no toolsThe MCP endpoint returns 503 until a tool policy exists
Time-based items do not advanceThere is no background runner; expiry changes when an operator acts