Troubleshooting

Real error messages and reason codes.

Message or symptomCause and fix
"Checkout isn't available for this store yet."Release gate failing. Open the Overview page and fix the blockers (STORE_POLICIES_REQUIRED, ACTIVE_MERCHANT_PROFILE_REQUIRED, KILL_SWITCH_ENABLED, LAUNCH_JURISDICTION_REQUIRED)
Place order disabledThe compliance decision is not allow. Read the reasons in the checkout panel, or in the Compliance Ledger
GENERIC_TAX_RATE_MUST_BE_ZERO_FOR_REGULATED_CARTSet the region's tax rate to 0
DESTINATION_JURISDICTION_UNRESOLVEDNo active jurisdiction matches US-<state>; add one
ACTIVE_POLICY_REQUIREDThe destination has no single active rule set
MERCHANT_LICENSE_REQUIREDRule set demands a licence; add an active verified one
FEDERAL_AUTHORIZATION_REQUIRED, PRODUCT_CLASSIFICATION_REQUIRED, MARKETING_REVIEW_REQUIREDComplete product evidence
Regulated cart denied for age, tax, or carrier evidenceProvider adapters have not recorded evidence. See Regulated checkout
"Accepted evidence is immutable…"Create a new revision or version instead of editing
"provider is unconfigured; regulated transactions remain disabled"No adapter configured for that provider contract
"Manual fulfillment is disabled for regulated orders"Buy a label with an approved carrier
Manual payment provider rejected at checkoutEnable Authorize.net, Stripe, or PayPal
Order stuck in requires_actionA payment webhook reported a problem; check the provider
Webhook events not deliveredTrigger retryWebhookDeliveries on a schedule
App refuses to startNeeds DATABASE_URL and a SESSION_SECRET of 32+ characters; S3 values are required in production
Product reverted to draftIts evidence was suspended, delisted, or revoked, or its image was replaced