ShipWave Channels

Connecting Walmart Marketplace

Authorize ShipWave from the Walmart Marketplace App Store. No API keys and nothing to paste.

Requirements

To connect Walmart Marketplace to ShipWave, you need:
  • An approved Walmart Marketplace seller account – Walmart requires an application and approval process
  • A connected store in ShipWave – your Shopify store is the product source for Walmart listings
  • Products with a GTIN/UPC, or a Walmart GTIN exemption for qualifying products
You do not need Walmart API keys. ShipWave is an approved Walmart Solution Provider and is authorized through Walmart's App Store.

How Walmart authorization works

Walmart authorizes ShipWave with OAuth 2.0 from Seller Center's App Store:
  1. Walmart opens ShipWave.
  2. You sign in to ShipWave if you are not already signed in.
  3. ShipWave sends you straight to Walmart's authorization page – there is no form in between.
  4. You review the requested access and approve it.
  5. Walmart returns you to your connected Walmart channel in ShipWave.
You never enter a Walmart Client ID, Client Secret, Consumer ID, or private key in ShipWave. ShipWave's own application credentials are used server-side to exchange Walmart's authorization code for tokens and are never shown to you. Seller tokens are stored encrypted (AES-256-GCM) and refreshed automatically.

Step-by-step connection

  1. Sign in to Walmart Seller Center at seller.walmart.com
  2. Open the App Store and find ShipWave
  3. Click Connect
  4. Sign in to ShipWave if prompted
  5. On Walmart's authorization page, review the access ShipWave requests and click Authorize
  6. You land on your Walmart channel in ShipWave with status Active
If ShipWave shows an Unlock or store prompt instead, connect your Shopify store under Admin → Stores first, then start again from Walmart's App Store.

Which store becomes the product source

The Walmart launch has no store picker, so ShipWave chooses for you: your only connected store, otherwise the store your other marketplace channels already use, otherwise your most recently updated store. You can review the source store on the channel page after connecting.

Disconnecting Walmart

On the Walmart channel page, click Disconnect Walmart and confirm. ShipWave immediately:
  • deletes the stored Walmart access token and refresh token
  • clears the Walmart seller ID from the channel
  • stops every Walmart job for the channel (order import, inventory, pricing, listing status, feed status, settlement reports)
  • marks the channel Disconnected and records who disconnected it and when in the channel's sync log
Everything that is not a credential is kept: channel settings, the source-store mapping, listings, pricing rules, inventory settings, historical orders and returns, sync logs, and Feed IDs. Disconnecting twice is harmless.

Reconnecting Walmart

On the channel page, click Reconnect with Walmart. ShipWave starts a fresh Walmart authorization for that same channel; approve it on Walmart's page and you return with the channel active again and nothing lost. You can also reconnect by clicking Connect on ShipWave in Walmart's App Store – ShipWave reuses your existing channel for that market rather than creating a second one. If Walmart revokes ShipWave's access on its side, the channel shows a reconnect-required state; use Reauthorize with Walmart on the channel page.

Expired or interrupted authorizations

  • "Walmart App Store launch has expired" – a launch from Walmart is valid for 30 minutes. Start again from Walmart's App Store or click Reconnect with Walmart. Your existing connection is not changed.
  • Authorization cancelled or denied – nothing changes on your channel; start again when ready.
  • Link already used – each authorization can be completed once; refreshing or using the back button on Walmart's return does not create a second connection.
  • Sandbox vs production – ShipWave keeps sandbox and production channels separate and refuses to attach a sandbox authorization to a production channel.

Walmart listing requirements

Walmart has strict listing requirements:
  • GTIN/UPC – a valid barcode, or a Walmart GTIN exemption for qualifying products.
  • Brand required – the brand field must be filled in.
  • Description required – products must have a description.
  • At least one image – product images are required.
  • Category required – products must be mapped to a Walmart product type.
ShipWave checks these against Walmart's current item specification before submitting and blocks the submission with the exact reason instead of sending incomplete data.

Walmart product matching

Walmart uses GTIN/UPC to match your products to their catalog. If your product's GTIN already exists in Walmart's catalog, your listing will be added as an offer on the existing product page (similar to Amazon). If the GTIN is new, Walmart will create a new product page. Product page creation can take 24-48 hours for Walmart to review.

Feed IDs and processing status

When you push a listing, Walmart accepts it asynchronously and returns a Feed ID. The listing shows Marketplace Processing with that Feed ID right away, keeps it through page reloads, and updates to the terminal result – success with the Walmart item ID, or per-item errors you can fix and resubmit – once ShipWave's feed-status poller reads Walmart's result. Inventory and pricing updates work the same way and show their own Feed IDs on the channel page.

Troubleshooting

"Multiple Walmart channels match this market"
  • You have two channels for the same Walmart market and environment. Remove or rename the duplicate, then reconnect the one you want to keep.
"Connect your store to ShipWave first"
  • Walmart listings need a product source. Connect your store under Admin → Stores, then start again from Walmart's App Store.
Listings rejected
  • Open the listing to see Walmart's exact error and the Feed ID. Fix the flagged field and push again.

FAQs

Does Walmart use OAuth?
Yes. Walmart Marketplace authorizes Solution Providers like ShipWave with OAuth 2.0 from Seller Center's App Store. Walmart retired seller-entered API keys for new Solution Provider connections in July 2026.
Can I connect with my Walmart API keys instead?
No. ShipWave never asks for a Walmart Client ID, Client Secret, Consumer ID, or private key. Start the connection from Walmart's App Store or with Reconnect with Walmart.
Do I need to rotate credentials?
No. There are no seller credentials in ShipWave to rotate. Walmart access tokens are short-lived and refreshed automatically; if Walmart ever revokes access, click Reauthorize with Walmart on the channel page.
Can I sell on Walmart without a GTIN/UPC?
Walmart supports GTIN exemptions for qualifying products (for example private-label or handmade items), including through the item setup API ShipWave uses. Otherwise you need valid GTINs, which you can obtain from GS1.
Does ShipWave support Walmart Fulfillment Services (WFS) or Ship with Walmart?
No. ShipWave manages seller-fulfilled Walmart orders: you ship with your own carrier accounts through ShipWave and ShipWave posts the carrier and tracking number back to Walmart through the Orders API.
How long does Walmart take to approve listings?
Most listings go live within 24 hours. New product pages (where the GTIN doesn't exist in Walmart's catalog) may take up to 48 hours for review.

More in ShipWave Channels

Back to Help Center