Troubleshooting

UCP manifest returns 404#

Cause: The rewrite rule for /.well-known/ucp is not in effect.
Fix: Go to Settings → Permalinks and click Save Changes (no need to change any option). This flushes rewrite rules and registers the UCP URL. Ensure permalinks are not set to “Plain”; any other structure is fine.

Stripe Connect fails or shows an error#

Cause: The Worker may be unreachable, or the Stripe OAuth redirect URI may not be configured correctly.
Fix: Confirm that COGNITIVE_CART_WORKER_URL is set (or the default Worker is reachable). In the Stripe Dashboard, under Connect → OAuth, ensure the redirect URI for your site is allowed. Check the Connectivity tab in CognitiveCart for any error message; you can also look at plugins/cognitive-cart/logs/stripe-connect-debug.log for details (local troubleshooting only).

Worker URL not configured#

Cause: The plugin cannot reach the CognitiveCart Worker (e.g. for Stripe Connect or manifest sync).
Fix: By default the plugin uses a hosted Worker. If you need to override it (e.g. for a custom Worker), add to wp-config.php: define( 'COGNITIVE_CART_WORKER_URL', 'https://your-worker.example.com' );. If the default Worker is down, contact support.

Checkout session creation fails#

Cause: Stripe not connected, Kill-Switch on, cart empty, or Worker/Stripe misconfiguration.
Fix: Ensure Stripe is connected in CognitiveCart → Connectivity, the Kill-Switch is off, and the cart has valid items. Check that your Stripe account and the Worker are set up for the store (see Stripe Connect & Checkout).

REST API returns 403 or 404#

Cause: Permalinks, security plugins, or server rules blocking /wp-json/.
Fix: Flush permalinks (Settings → Permalinks → Save). Temporarily disable security or firewall plugins that might block REST requests. Ensure your server does not block /wp-json/cognitive-cart/v1/.