---
title: "Troubleshooting"
description: "Troubleshoot CognitiveCart: UCP manifest 404, Stripe Connect errors, Worker URL, permalinks, and common issues."
url: "https://docs.cognitivecartplugin.com/support/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](../../features/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/`.

If you’re still stuck, open a ticket at [gauchoplugins.com/support](https://gauchoplugins.com/support) with your WordPress and WooCommerce versions, what you tried, and any error messages or log excerpts (no passwords or keys).