Walmart Marketplace uses OAuth 2.0 Client Credentials — no browser redirect is required. You enter your Walmart Client ID and Client Secret directly in the portal. Walmart operates in the US marketplace only (region = US, currency = USD).
Log in to the Walmart Seller Center and navigate to Account → Developer Portal. Create an application to receive your Client ID and Client Secret.
Ensure your Walmart Marketplace account is approved and in good standing. Credentials from a Sandbox account (sandbox.walmartapis.com) cannot be used against the production endpoint and vice versa.
Have your Client ID and Client Secret ready. Keep them confidential — treat them like a username and password.
Walmart access tokens expire after 15 minutes. Sugibana re-fetches fresh tokens automatically when the cached token is within 5 minutes of expiry. There is no refresh token — each stale token triggers a new POST /v3/token call using your stored credentials.
On the Sales Channels page, click Connect Walmart. Select Production or Sandbox environment.
Enter your Client ID and Client Secret. Click Save. The secret is AES-encrypted immediately and never returned to the client after this point.
The Walmart card will show Connected. Click Validate to confirm the credentials work against the Walmart token endpoint.
Enable the Order sync toggle. Orders will begin importing in the next 5-minute polling cycle.
Every Walmart API request requires five specific headers including WM_CONSUMER.CHANNEL.TYPE (must be present as an empty string — omitting it entirely can cause authentication failures). Sugibana handles all required headers automatically.
Orders are polled every 5 minutes via /v3/orders/created using cursor-based pagination. The poll loops until nextCursor is null.
Walmart order status is per order line, not top-level. Status mapping: Created → Pending; Acknowledged → Unshipped; Shipped / Delivered → Shipped; Cancelled / Refund → Cancelled.
Walmart orderDate is in Unix milliseconds (not seconds). Always convert using new Date(orderDate).toISOString() — using it as seconds produces a date near 1970.
Walmart stock push uses the asynchronous Feed API. A feed is submitted via POST /v3/feeds?feedType=inventory and returns a feedIdimmediately. Processing takes 2–10 minutes.
Sugibana polls GET /v3/feeds/{feedId} until the feed reaches PROCESSED status. Failed items are logged in the Incidents panel.
Enable the Stock push toggle on the Walmart card. Ensure the walmart_offer_mapping table has a row for each SKU (seller SKU must match exactly).
The feed sku field must match the seller-assigned SKU code in Walmart's catalog. A mismatch causes items to be rejected at the feed processing step with an "item not found" error.