> This page is for Developer.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.bigcommerce.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.bigcommerce.com/_mcp/server.

## Troubleshooting guide for Catalyst session sync

The Catalyst Session Sync page now includes a troubleshooting section covering the most common causes of `Invalid JWT token` errors and `404` responses during checkout.

* **Seven failure modes** — each with its symptom, cause, and fix: edge runtime in the checkout and login-token routes, an OAuth token set as `BIGCOMMERCE_STOREFRONT_TOKEN`, a channel ID that doesn't match the channel owning the custom domain, a custom domain not set as the channel's primary storefront URL, incomplete DNS propagation, pending domain verification, and 30-second JWT expiry under slow redirects.
* **Decoding the session-sync JWT** — how to inspect the `channel_id`, `redirect_to`, and `eat` claims to pinpoint a misconfiguration.

For details, see [Session Sync](/developer/docs/storefront/catalyst/development/session-sync).