Cancel Order Lines
POST/api/walmart/:integrationInstance/orders/:order/cancel-lines
Cancel order lines on Walmart (seller-initiated cancellation).
Not yet available to API tokens
This endpoint currently requires session authentication; Personal Access Token scope support is in progress.
Authentication: Requires Bearer token.
Fields:
- lines (optional, array): Lines to cancel. When omitted, every line still in a cancellable status (Created or Acknowledged) is cancelled.
- lines[].lineNumber (required with lines, string): Walmart order line number.
- lines[].amount (required with lines, integer): Quantity to cancel on that line.
- reason (optional, string): The cancellation reason sent to Walmart. One of
SELLER_CANCEL_OUT_OF_STOCK(out of stock, the default when omitted),CUSTOMER_REQUESTED_SELLER_TO_CANCEL(the buyer asked to cancel),SELLER_CANCEL_PRICING_ERROR,SELLER_CANCEL_ADDRESS_NOT_SERVICEABLEorSELLER_CANCEL_FRAUD_STOP_SHIPMENT. Walmart counts seller-caused cancellations against your cancellation rate, so sendCUSTOMER_REQUESTED_SELLER_TO_CANCELwhen the buyer requested it. Any other value returns 422 and nothing is sent to Walmart.
Requires the sales_orders.cancel permission.
Request
Responses
- 200
- 401
- 403
- 404
- 422
- 429
OK
Response Headers
Content-Type
Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.
Forbidden
Response Headers
Content-Type
Not found — no record with the given identifier (or the route does not exist). Verify the ID before retrying.
Unprocessable Entity
Response Headers
Content-Type
Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.