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:
-
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.
-
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. - If your application includes a user interface, present the available return policy options.
- 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.
- Set the value for the Item.ReturnPolicy.ReturnsWithinOption argument to the number of days a buyer has to return or exchange the item. Refer to ReturnsWithinOptionsCodeType for the list of supported values.
Set the value for the Item.ReturnPolicy.RefundOption to the desired refund policy (e.g., Money Back). Refer to RefundOptionsCodeType for the list of supported values.
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
.