Salesforce Docs Portal

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 Timeouts and Limits, Code Profiler
429 Too Many Requests Throttle Rates Error Response Codes
401/403 authorization errors Authorization Authorization Scopes, SLAS
400 request validation errors Error Response Codes Commerce API references
500/internal errors SCAPI Logs and Request Tracking Code Profiler
Unexpected response behavior Response Handling Commerce API references
Wrong or stale personalized response Troubleshoot Personalized Caching Personalization and Custom Code
Stale SCAPI data after a content update Cache Invalidation SCAPI zone or cachePurge
Low SCAPI cache hit rates View Cache Statistics Improve the Cache Hit Ratio

Troubleshooting Resources

The B2C Commerce APIs provide capabilities to help you:

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.

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 for common status codes

3. Review Logs

Use Log Center in Business Manager to: