WooCommerce: “There appears to be a problem with your site’s checkout configuration”

Quick win checklist (fastest first)

1. Assign Checkout & Cart pages: WooCommerce → Settings → Advanced → Page setup. Set both, then click Save changes.
2. Open the Checkout page in the editor: Confirm the page uses the Checkout Block (not a broken layout). Update the page once.
3. Enable at least one payment method: WooCommerce → Settings → Payments. Turn on a gateway and complete setup.
4. Ensure a shipping method applies: WooCommerce → Settings → Shipping. Your customer region must match a zone that has a method (Flat rate/Free/Local pickup).
5. Flush permalinks & caches: Visit Settings → Permalinks and click Save. Purge server/page/CDN caches.
6. Check the REST API: Your store endpoints must be reachable. See test below.

Step-by-step fixes

1) Verify WooCommerce page assignments

Go to WooCommerce → Settings → Advanced. Under Page setup, assign:

• Cart page → “Cart”
• Checkout page → “Checkout”
• Click Save changes.

If those pages don’t exist, create them (Pages → Add New) and add the correct block to each page:

Cart page → Add block: “Cart”
Checkout page → Add block: “Checkout”

Tip: If the classic shortcodes were used previously, remove them to avoid conflicts.

2) Confirm the Checkout Block isn’t broken

1. Edit the “Checkout” page in the block editor.
2. Make sure you see a single top-level Checkout block (no nested shortcodes or duplicated sections).
3. Click Update to refresh the saved markup.

3) Turn on a payment method

At least one gateway must be active and configured. Go to WooCommerce → Settings → Payments, enable a method (e.g., WooCommerce Payments, Stripe, PayPal) and complete the setup wizard. For testing, also enable Cash on delivery or Check payments to rule out gateway setup issues.

4) Ensure shipping is available (for physical items)

If your products require shipping, the customer’s address must match a zone with an active method:

1. Open WooCommerce → Settings → Shipping → Shipping zones.
2. Make sure the zone includes the countries/regions you serve.
3. Add a method (Flat rate, Free shipping, Local pickup) and configure costs.

No shipping needed? Set products to Virtual to bypass shipping logic while testing.

5) Refresh routes & caches

• Permalinks: visit Settings → Permalinks and click Save (this flushes rewrite rules).
• Clear caching: purge any page/server cache (LiteSpeed, WP Rocket, W3TC), object cache (Redis/Memcached), and CDN (Cloudflare, etc.). Temporarily bypass cache on /checkout.

6) Confirm the Store API is reachable

The Checkout Block uses the WooCommerce Store API. Test that it returns JSON (not HTML or a 403/500):

# Replace example.com with your domain
curl -I https://example.com/wp-json/wc/store/v1/cart
curl -I https://example.com/wp-json/wc/store/v1/checkout

Expected: HTTP/2 200 and a JSON content-type. If you see a firewall/maintenance page or 403, allowlist the REST API in security plugins/proxies and retest.

7) Rule out theme & plugin conflicts

1. Switch to a default theme (Twenty Twenty-Five) temporarily.
2. Disable all plugins except WooCommerce. If Checkout works, re-enable plugins in batches to identify the conflict (payment, security, caching, optimization, or page-builder add-ons are common culprits).

# WP-CLI (optional, use on staging)
wp plugin deactivate --all
wp plugin activate woocommerce
# then re-activate in batches to find the offender

8) Fix common misconfigurations

• Missing Woo pages: WooCommerce → Status → Tools → Create default WooCommerce pages (if needed).
• Out-of-date DB schema: WooCommerce → Status → run the Database update notice if shown.
• HPOS compatibility: If High-Performance Order Storage is enabled, ensure all payment/shipping plugins declare compatibility or temporarily turn HPOS off to test.
• Mixed modes: Don’t mix the classic [woocommerce_checkout] shortcode and the Checkout Block on the same page.

9) Minimal reproduction (helps pinpoint the cause)

1. Create a fresh page “Checkout (Test)” with only the Checkout block.
2. Temporarily assign it under WooCommerce → Settings → Advanced → Checkout page.
3. Test again. If this page works, the original page layout or a page-builder template likely caused the error.

Troubleshooting quick tests

• Payment & shipping sanity check: enable “Cash on delivery” + “Flat rate” and place a test order.
• Guest checkout: allow guest checkout in WooCommerce → Settings → Accounts & Privacy while testing.
• Console & network: open DevTools on /checkout and look for failed requests to /wp-json/wc/store/.

FAQ

Can I fall back to the classic shortcode?
Yes, temporarily use the [woocommerce_checkout] shortcode on a test page to confirm orders can complete. Don’t leave both the shortcode and the Block active long-term on the same assigned Checkout page.

The message still shows, what next?
Check WooCommerce → Status for Fatal errors, re-run the database update (if offered), and review your server/PHP error logs. If a specific plugin triggered it, open a ticket with that vendor including your Status report.

Once Checkout works, revert any temporary test settings (e.g., disable test gateways, re-enable your theme/plugins).