---
schema_version: "1"
id: d0e98938271f41674eb0dfd0c6aa3abc845d8f7ca0e458e7ec898d6a075aafe3
title: Hybrid Auth Troubleshooting
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/commerce-cloud/b2c-commerce/guides/hybrid-auth-troubleshooting.md
canonical_url: https://developer.salesforce.com/docs/commerce/pwa-kit-managed-runtime/guide/hybrid-auth-troubleshooting.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: cc7342618c3240ce0afb6481f315cb0905f818a81d98a75605bbe37935803a23
products:
  - Composable Storefront
  - Salesforce APIs
---
# Hybrid Auth Troubleshooting

Use this guide to diagnose common Hybrid Auth implementation issues.

## Hybrid Auth Not Applying

- Confirm Hybrid Auth is enabled in Business Manager for the active site.
- Confirm storefront uses the expected SLAS client ID.

## Token or Session Drift Across Runtimes

- Validate SLAS client scope includes `sfcc.session_bridge`.
- Confirm headless runtime forwards and accepts required cookies/headers.
- Confirm route ownership does not cause auth loops between origins.

## eCDN Routing Mismatch

- Validate route rules and order in Business Manager.
- Verify hostnames and target origin configuration.
- Confirm cart/checkout routes still map to intended origin.
- Check hybrid route ownership guidance for your architecture: Storefront Next [Hybrid Storefront Routing Matrix](https://developer.salesforce.com/docs/commerce/sfnext/guides/sfnext-hybrid-routing-matrix.md) or PWA Kit [Hybrid Storefront Routing Matrix (PWA Kit)](https://developer.salesforce.com/docs/commerce/pwa-kit-managed-runtime/guides/hybrid-routing-matrix.md).

## Localhost and Sandbox Differences

- Use proxy routing for localhost, not production eCDN settings.
- Confirm ODS/PIG-specific settings align with environment requirements.
- Confirm environment-specific setup for your architecture: Storefront Next [Set Up Hybrid Proxy Locally](https://developer.salesforce.com/docs/commerce/sfnext/guides/sfnext-hybrid-proxy-local-dev.md) or PWA Kit [Configure a Hybrid Storefront with Hybrid Auth (PWA Kit)](https://developer.salesforce.com/docs/commerce/pwa-kit-managed-runtime/guides/hybrid-auth.md).

## Missing SCAPI Short Code on On-Demand Sandboxes (ODS)

- If session-bridge authentication fails with the error `Cannot construct SLAS session-bridge URL: no ACTIVE SCAPI short code found for this organization`, the ODS realm has no active SCAPI short code.
- Generate a dedicated short code for the realm in Business Manager to resolve the error. No Support ticket is required. The previously shared common short code (`kv7kzm78`) still works, but a dedicated short code is required for SLAS hybrid authentication.
- For instructions, see [Base URL and Request Formation](https://developer.salesforce.com/docs/commerce/commerce-api/guides/base-url.md#short-code) and [Generate a Short Code and Create an API Client ID](https://help.salesforce.com/s/articleView?id=cc.b2c_generate_a_shortcode_and_api_client_id.htm&type=5).