Reference · built on requestConnectorCommerce & orders

Walmart Marketplace

Purchase orders, order lines, and inventory by ship node from a Walmart Marketplace seller account.

Request accessPricing ↗

About

Walmart Marketplace is the third-party seller program on Walmart.com and its sister sites in Canada, Chile, and Mexico. The Marketplace APIs are OAuth 2.0 REST endpoints under /v3: orders and released orders, acknowledgement, shipping updates, cancellations, refunds, inventory by SKU and ship node, items, prices, and reports. Access tokens last 15 minutes; every request carries WM_SEC.ACCESS_TOKEN, WM_QOS.CORRELATION_ID, and WM_SVC.NAME headers.

An operator on Fibric reads released orders, proposes the acknowledgement, then the shipping update with carrier and tracking, or a cancellation or refund for a line, each for your approval and each with a receipt.

This is a reference listing. It documents what Fibric would read from Walmart Marketplace and what it could propose, based on the vendor's published interfaces. Fibric builds it under a managed deployment when you request it; selecting it here installs nothing.

Inputs

  • Orders through GET /v3/orders, filtered by status, SKU, created dates, expected ship dates, or last-modified dates
  • Released orders through GET /v3/orders/released: lines in Created status, handed to the seller to fulfill
  • Order line status: Created, Acknowledged, Shipped, Delivered, or Cancelled, with a quantity per line
  • Inventory for a SKU at the default ship node with GET /v3/inventory, or across ship nodes with GET /v3/inventories/{SKU}
  • Order type, replacement details, and product images and weight when productInfo is requested

Proposed actions

  • Target capability: propose acknowledging a purchase order with POST /v3/orders/{purchaseOrderId}/acknowledge
  • Target capability: propose a shipping update with carrierName, methodCode, trackingNumber, and shipDateTime
  • Target capability: propose cancelling a line with a reason such as SELLER_CANCEL_OUT_OF_STOCK
  • Target capability: propose a refund on shipped lines with a refundReason and charge breakdown
  • Target capability: propose an inventory quantity update by SKU and ship node

Proposed actions are target capabilities. Every action runs propose-first and needs a validated deployment and the appropriate permissions.

What you can build

  • Acknowledge every released order on time

    Poll released orders, check stock at the ship node, and propose the acknowledgement so the line moves from Created to Acknowledged.

    With Order Risk, Promise Date

  • Ship, then tell Walmart in the same minute

    Take the carrier and tracking number from the label and propose the shipping update, which captures the customer's payment.

    With Tracking Sync, Carrier Exception

  • Cancel out-of-stock lines with the right code

    When a short pick is confirmed, propose cancelling the line with SELLER_CANCEL_OUT_OF_STOCK and a customer notice.

    With Short Pick, Backorder Notice

  • Refund shipped lines only after the return lands

    Match the return to the order line, then propose a refund with isFullRefund or itemized charges and a refundReason.

    With Returns Triage, Refund Policy

Requirements

  • A Walmart Marketplace seller account with API credentials generated in the Developer Portal
  • For a solution provider, the seller's delegated authorization code and a refresh token, valid for one year
  • WM_QOS.CORRELATION_ID and WM_SVC.NAME on every call, and WM_MARKET set to us, ca, or mx where required
  • SKUs already set up as items before inventory can be read or updated
Authentication
OAuth 2.0: a Client ID and Client Secret from the Walmart Developer Portal are exchanged at https://marketplace.walmartapis.com/v3/token for an access token that expires after 15 minutes.

Limits

  • Get all orders returns orders from the last 180 days, at most 10,000 per query, with limit capped at 200 per page
  • Refunds apply only to lines already Shipped; cancellations carry one of five fixed reason codes
  • SELLER_CANCEL_OUT_OF_STOCK marks the item unavailable until inventory is replenished
  • This reference listing reads orders by polling Get all orders; it does not depend on a push feed

Access and pricing

Reference listing. Fibric builds the connector under a managed deployment when you request it. Your quote covers the build, capabilities, usage, and support.

Request Walmart Marketplace ↗

Questions and answers

How far back can orders be fetched?
Get all orders and Get all released orders return orders created in the last 180 days, and one query can fetch at most 10,000 orders; more returns an error. The default window for released orders is the past 7 days. Page size is set with limit, up to 200.
What happens when a shipping update is posted?
The order lines named in the request are marked Shipped, the customer's payment is captured, and the tracking details you supply are recorded: shipDateTime as a UNIX epoch, carrierName, methodCode, trackingNumber, and a trackingURL for custom carriers. Later tracking edits use processMode PARTIAL_UPDATE.
When does a Walmart access token expire?
15 minutes. The connector reads expires_in and requests a new token from the Token API before it lapses. A solution provider acting for a seller holds a refresh token that stays valid for one year and exchanges it with grant_type=refresh_token.
Ask about Walmart Marketplace

Ask about the capabilities and requirements in this listing.

For project-specific requirements, contact Fibric.

This connector listing is developed, published, and supported by Fibric. It describes integration with Walmart Marketplace through published interfaces. Third-party names and logos identify the systems an integration connects to; they are the property of their respective owners, who are not affiliated with Fibric and do not sponsor or endorse this listing. Trademark policy