Sellers can cancel an order up to 30 days after checkout.

There are several scenarios where a seller might want to cancel an order. For example, the buyer might have contacted the seller directly to request a cancellation, or the seller might realize the purchased item is out of stock. The "out-of-stock" cancellation reason will result in a defect on the seller's account, but there will be no negative effect on the seller's account if the seller is only canceling the order at the request of the buyer. Sellers must make sure they give the correct cancellation reason.

Seller-Initiated Cancellation Flow

Note: If the buyer requests a cancellation using a method other than the eBay Web flow, and the seller decides against canceling the order, the seller should inform the buyer of their decision. Refer to Rejecting Buyer-Requested Cancellations in the Post-Order API User Guide.

To cancel an order:

  1. Get the Order ID with a call to GetOrders.

    Note that the Trading API OrderID field is named legacyOrderId in the Post-Order API.

  2. Check the cancellation eligibility of the order. (Optional)

    Call POST /post-order/v2/cancellation/check_eligibility to ensure that the order is eligible for cancellation.

  3. Cancel the order.

    Call POST /post-order/v2/cancellation and set the cancelReason to one of the following three values:

    • BUYER_ASKED_CANCEL: This value is given by the seller if the seller is canceling the order on behalf of the buyer. This cancel reason will not result in a defect on the seller's record.
    • ADDRESS_ISSUES: This value is given by the seller if the buyer has provided the seller with an undeliverable/bad shipping address. This cancel reason will not result in a defect on the seller's record.
    • OUT_OF_STOCK_OR_CANNOT_FULFILL: This value is given by the seller if the seller is canceling the order due to the item being out of stock or another fulfillment issue. This cancel reason will result in a defect on the seller's record.

    If the order was paid for, eBay automatically issues a full refund to the buyer.