Guides
My Account

Troubleshooting and support

My API call is failing, where should I start?
  • Check HTTP status and error body.
  • Verify token (environment, token expiry, API scopes).
  • Validate payload against the items schema/spec.
  • Reproduce with a minimal curl call.
  • Capture correlation/request ID and timestamp (UTC) for support.
My feed fails with ‘Malformed data’ or ERR_PDI_0001 / ERR_PDI_0034. What now? These errors signal feed-file issues: missing elements, invalid characters, or incorrect field values. Validate feeds against the latest XSD, remove invalid symbols, and ensure required fields are present before resubmitting.
Why can’t I cancel, refund, or ship certain orders? Requests fail when an order is already shipped, cancelled, or outside the valid timeframe. Retrieve the order details first to confirm current status and eligibility.
How can I check if an API service is down or degraded? Use the API Health Dashboard on developer.walmart.com. Persistent 500/503 errors may indicate service degradation—retry later and contact support with correlation IDs if unresolved.
What are common issues during item setup (cataloging)? Frequent errors include invalid GTIN/UPC lengths, conflicting titles/prices, and outdated spec versions. Always use the latest item spec and ensure accurate product data.
Sandbox and production return different results, what should I do? Confirm you’re using the correct base URL and credentials for each environment. Some validations or latency differ in sandbox; always re-test critical flows with a small canary in production.
Why did my Solution Provider app connection stop working?

App connections expire after one year. Reauthorize if expired. Check that OAuth scopes remain valid and credentials (Consumer ID/Private Key) haven’t been revoked.

Additional Tips:

  • Include correlation IDs (WM_QOS.CORRELATION_ID) in requests to aid support.
  • Avoid concurrent updates to the same SKU to prevent ‘Resource Is Locked (423)’ errors.
  • Track Walmart item spec version updates to prevent validation failures. For the latest item spec releases, refer to Item spec: versioning and diff reporting
  • Monitor API traffic reports to identify recurring 4xx errors and systemic issues.
How do I report an issue or contact support? Open a ticket via the developer portal. Include: environment, endpoint, full request/response (sanitized), correlation ID, timestamps (UTC), and frequency (one-off vs pattern). For suspected incidents (widespread 5xx), check the status/health page first.

Updated 1 day ago