A return policy is required for auction and fixed-price listings in most categories. Sellers can choose not to accept returns, but they must still specify this policy clearly.

Sellers opted into and using Business Policies do not use the Item.ReturnPolicy container, but instead will specify the return business policy to use through the Item.SellerProfiles.SellerReturnProfile field.

Argument: Item.SellerProfiles.SellerReturnProfile

Add a return policy to a listing

To include your return policy in a listing:

  1. To determine which categories require a return policy call GetCategoryFeatures for the marketplace on which an item is to be listed. In most cases, when the value of ReturnPolicyEnabled is true a return policy is required. However, for the eBay Australia (AU) and US eBay Motors Parts and Accessories marketplaces, most categories support but do not require a return policy.

    If either the primary or secondary category in the listing requires a return policy, then the listing must include a return policy.

  2. For the marketplace on which the item will be listed, call GeteBayDetails to determine which return policy fields are supported and which values are supported.

    Set the value of the DetailName argument to ReturnPolicyDetails. Review the ReturnPolicyDetails field in the response as this container will contain all of the supported values for return policies.

  3. If your application includes a user interface, present the available return policy options.
  4. When listing the item using AddItem or related calls, specify the supported values returned in GeteBayDetails into the corresponding return policy options in the Item.ReturnPolicy fields.

    To verify which Item.ReturnPolicy.ReturnsWithinOption and Item.ReturnPolicy.RefundOption values are allowed for a specific marketplace, call GeteBayDetails and set the value of the DetailName argument to ReturnPolicyDetails.