Walmart – Gotchas

When the created_since filter is not provided, Walmart only returns orders from the last 7 days. To retrieve older orders, supply filter[created_since] with the desired start date (e.g. ?filter[created_since]=2024-01-01T00:00:00Z).

Walmart applies markdowns before serializing orders. line_items[].total_amount is the PRODUCT charge amount plus applicable tax (chargeAmount.amount + tax.taxAmount.amount on the charge where chargeType === 'PRODUCT'). Walmart only exposes two charge types (PRODUCT and SHIPPING); discounts are pre-applied and not broken out separately in the order response.

Walmart's order API does not expose a payment status. payment_status is inferred from the order line status: active orders (Created/Acknowledged/Shipped/Delivered) report paid because Walmart Marketplace collects customer payment upfront; Cancelled reports voided and Refund reports refunded. total_amount is derived by summing line-item charges (incl. tax) when Walmart omits the order-level orderSummary.

Walmart applies markdowns before serializing orders. line_items[].total_amount is the PRODUCT charge amount plus applicable tax (chargeAmount.amount + tax.taxAmount.amount on the charge where chargeType === 'PRODUCT'). Walmart only exposes two charge types (PRODUCT and SHIPPING); discounts are pre-applied and not broken out separately in the order response.

Walmart's order API does not expose a payment status. payment_status is inferred from the order line status: active orders (Created/Acknowledged/Shipped/Delivered) report paid because Walmart Marketplace collects customer payment upfront; Cancelled reports voided and Refund reports refunded. total_amount is derived by summing line-item charges (incl. tax) when Walmart omits the order-level orderSummary.

The cursor for Walmart expires if it has not been used within 2 minutes of the last request.