--- schema_version: "1" id: 173f442daffccf664b8ab460edbd98b860d13b234597d642b80a1c2e6aa75138 title: Troubleshoot collection: developer version: current locale: en-us portal_url: https://docs.salesforce.com/developer/current/en-us/commerce-cloud/commerce-api/guides/troubleshoot.md canonical_url: https://developer.salesforce.com/docs/commerce/pwa-kit-managed-runtime/guide/troubleshoot.html source_site: developer.salesforce.com content_type: documentation content_hash: 31a4fec1b52582aaf4405ec095fc402c3fe963f55ab79c97af4a51ff5ed29873 products: - Composable Storefront - Salesforce APIs --- # Troubleshoot Navigate through our API troubleshooting information to efficiently address and resolve issues you encounter. ## Quick Triage: Find Your Solution Use this table as a first-stop navigation aid. It points to likely starting resources, not definitive root causes. | Symptom | Start Here | Next Check | | :------------------------------------------ | :----------------------------------------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **504 Gateway Timeout** | [Troubleshoot Request Timeouts](https://developer.salesforce.com/docs/commerce/pwa-kit-managed-runtime/guide/timeout-troubleshoot.md) | [Timeouts and Limits](https://developer.salesforce.com/docs/commerce/pwa-kit-managed-runtime/guide/timeouts-limits.md), [Code Profiler](https://developer.salesforce.com/docs/commerce/pwa-kit-managed-runtime/guide/code-profiler.md) | | **429 Too Many Requests** | [Throttle Rates](https://developer.salesforce.com/docs/commerce/pwa-kit-managed-runtime/guide/throttle-rates.md) | [Error Response Codes](https://developer.salesforce.com/docs/commerce/pwa-kit-managed-runtime/guide/error-response-codes.md) | | **401/403 authorization errors** | [Authorization](https://developer.salesforce.com/docs/commerce/pwa-kit-managed-runtime/guide/authorization.md) | [Authorization Scopes](https://developer.salesforce.com/docs/commerce/pwa-kit-managed-runtime/guide/auth-z-scope-catalog.md), [SLAS](https://developer.salesforce.com/docs/commerce/pwa-kit-managed-runtime/guide/slas.md) | | **400 request validation errors** | [Error Response Codes](https://developer.salesforce.com/docs/commerce/pwa-kit-managed-runtime/guide/error-response-codes.md) | [Commerce API references](https://developer.salesforce.com/docs/commerce/commerce-api/references) | | **500/internal errors** | [SCAPI Logs and Request Tracking](https://developer.salesforce.com/docs/commerce/pwa-kit-managed-runtime/guide/scapi-logs-request-tracking.md) | [Code Profiler](https://developer.salesforce.com/docs/commerce/pwa-kit-managed-runtime/guide/code-profiler.md) | | **Unexpected response behavior** | [Response Handling](https://developer.salesforce.com/docs/commerce/pwa-kit-managed-runtime/guide/response-handling.md) | [Commerce API references](https://developer.salesforce.com/docs/commerce/commerce-api/references) | | **Wrong or stale personalized response** | [Troubleshoot Personalized Caching](https://developer.salesforce.com/docs/commerce/pwa-kit-managed-runtime/guide/server-side-web-tier-caching.md#troubleshoot-personalized-caching) | [Personalization and Custom Code](https://developer.salesforce.com/docs/commerce/pwa-kit-managed-runtime/guide/server-side-web-tier-caching.md#personalization-and-custom-code) | | **Stale SCAPI data after a content update** | [Cache Invalidation](https://developer.salesforce.com/docs/commerce/pwa-kit-managed-runtime/guide/server-side-web-tier-caching.md#cache-invalidation) | [SCAPI zone](https://help.salesforce.com/s/articleView?id=cc.b2c_scapi_zone.htm&type=5) or [cachePurge](https://developer.salesforce.com/docs/commerce/commerce-api/references/zones?meta=cachePurge) | | **Low SCAPI cache hit rates** | [View Cache Statistics](https://developer.salesforce.com/docs/commerce/pwa-kit-managed-runtime/guide/server-side-web-tier-caching.md#view-cache-statistics) | [Improve the Cache Hit Ratio](https://developer.salesforce.com/docs/commerce/pwa-kit-managed-runtime/guide/server-side-web-tier-caching.md#improve-the-cache-hit-ratio) | ## Troubleshooting Resources The B2C Commerce APIs provide capabilities to help you: - [Analyze response bodies to identify maintenance issues and actions to take](https://developer.salesforce.com/docs/commerce/pwa-kit-managed-runtime/guide/response-handling.md). - [Check error response codes](https://developer.salesforce.com/docs/commerce/pwa-kit-managed-runtime/guide/error-response-codes.md). - [Set rate limits](https://developer.salesforce.com/docs/commerce/pwa-kit-managed-runtime/guide/throttle-rates.md). - [Timeouts](https://developer.salesforce.com/docs/commerce/pwa-kit-managed-runtime/guide/timeout-troubleshoot.md). - [Monitor SCAPI API performance](https://developer.salesforce.com/docs/commerce/pwa-kit-managed-runtime/guide/code-profiler.md). - [View SCAPI logs and track requests](https://developer.salesforce.com/docs/commerce/pwa-kit-managed-runtime/guide/scapi-logs-request-tracking.md). - [Timeouts and Limits](https://developer.salesforce.com/docs/commerce/pwa-kit-managed-runtime/guide/timeouts-limits.md). - If data stays stale after [cache invalidation](https://developer.salesforce.com/docs/commerce/pwa-kit-managed-runtime/guide/server-side-web-tier-caching.md#cache-invalidation), purge the cache by tag or path in the [SCAPI zone](https://help.salesforce.com/s/articleView?id=cc.b2c_scapi_zone.htm&type=5) or with [cachePurge](https://developer.salesforce.com/docs/commerce/commerce-api/references/zones?meta=cachePurge). ## Step-by-Step Troubleshooting Process When you encounter an API issue, follow these steps: ### 1. Identify the Request Every SCAPI response includes a `correlationID` header. Use this to [track and investigate request details](https://developer.salesforce.com/docs/commerce/pwa-kit-managed-runtime/guide/scapi-logs-request-tracking.md#investigate-by-correlation-id). ### 2. Check the Response - Review the HTTP status code and response body - Look for error messages and error details in the response - See [Error Response Codes](https://developer.salesforce.com/docs/commerce/pwa-kit-managed-runtime/guide/error-response-codes.md) for common status codes ### 3. Review Logs Use Log Center in Business Manager to: - Search by `correlationID` - Enable `verbose` logging for detailed request traces - Filter for errors and exceptions - See [SCAPI Logs and Request Tracking](https://developer.salesforce.com/docs/commerce/pwa-kit-managed-runtime/guide/scapi-logs-request-tracking.md)