eBay Business Policies Management APIVersion 1.1.0

ReturnPolicyInfo

Type defining the returnPolicyInfo container, which consists of detailed information on a seller's return policy.

Type that uses ReturnPolicyInfo:

Calls that use ReturnPolicyInfo:

Fields



description ( string ) [0..1]
This field contains the seller's detailed explanation for their return policy and is displayed in the Return Policy section of the View Item page. This field is valid in only the following marketplaces (the field is otherwise ignored):
  • Germany (DE)
  • Spain (ES)
  • France (FR)
  • Italy (IT)
Where valid, sellers can use this field to add details about their return policies. eBay uses this text string as-is in the Return Policy section of the View Item page. Avoid HTML and avoid character entity references (such as £ or £). If you include special characters in the return policy description, use the literal UTF-8 or ISO-8559-1 character (e.g. £).
See the Field Index to learn which calls use description.

holidayReturns ( token ) [0..1]
This field is deprecated as of v1.1.0 and any values supplied in this field are ignored. eBay no longer supports holiday returns.
See the Field Index to learn which calls use holidayReturns.

refundOption ( token ) [0..1]
This field indicates how the seller compensates buyers for remorse returns. You must set this value to MoneyBack for all eBay marketplaces except for the US marketplace.

On EBAY_US: You can set this value to either MoneyBack or MoneyBackOrReplacement. If a seller has the depth of inventory to support an exchange for an identical item, you can set MoneyBackOrReplacement. Otherwise, eBay recommends you set this value to its default value, MoneyBack.
See the Field Index to learn which calls use refundOption.

restockingFeeValue ( token ) [0..1]
This field is deprecated as of v1.1.0 and any values supplied in this field are ignored. eBay no longer supports restocking fees for returned items.
See the Field Index to learn which calls use restockingFeeValue.

returnsAcceptedOption ( token ) [0..1]
This required field indicates whether or not the seller accepts returns.

Applicable values are ReturnsAccepted or ReturnsNotAccepted. When set to ReturnsAccepted, this option indicates the seller allows items to be returned. Specify ReturnsNotAccepted for an item if the seller does not accept returns.

On the eBay DE, IE, and UK, registered business sellers must accept returns for fixed-price items (including auction items with Buy It Now and any other fixed price formats) when the category requires a return policy. On some European sites, such as eBay Germany (DE), registered business sellers are required to accept returns. Use the Trading call GetUser to determine the status of an eBay business seller in DE, IE, and UK. Review the User.SellerInfo.SellerBusinessType field in the response.

Note: In order for Top-Rated sellers to receive a Top-Rated Plus seal for their listings, returns must be accepted for their items (returnsAcceptedOption = ReturnsAccepted) and handling time should be set to zero-day (same-day shipping) or one-day shipping. Set the handling time (in days) using the Item.DispatchTimeMax field.
Top-Rated listings qualify for the greatest average boost in Best Match and for the 20 percent Final Value Fee discount. For more information on eBay's Top-Rated seller program, see the Becoming a Top Rated Seller and qualifying for Top Rated Plus page.



For setSellerProfile: Updating the values in a business profile can effect the profiles in currently-listed items. In most cases, the updates made to a business policy can be streamlined into existing listings. However, if you update a business policy and the policy is invalid in the category where an item is listed, no error will be thrown and the policy will carry through the regular life of the listing. Sellers will be unable to re-list an item if it refers an invalid policy. Also note eBay will not update the policy's of a description if the listing has bids or sales, or if the listing ends within 12 hours.
See the Field Index to learn which calls use returnsAcceptedOption.

returnsWithinOption ( token ) [0..1]
Specifies the amount of time the buyer has to return an item. The return period begins when the item is marked "delivered" at the buyer's specified ship-to location. Most marketplaces and categories support 30-day and 60-day return periods. eBay sites often set 30-days as the default value for this field and sellers are obligated to honor the values that are set for a listing. This value is required if ReturnsAcceptedOption=ReturnsAccepted.

Applicable values: Retrieve the values supported by a marketplace by calling GeteBayDetails with DetailName set to ReturnPolicyDetails, then review ReturnPolicyDetails.ReturnsWithin.ReturnsWithinOption in the response.

Note: In version 1.1.0, the options for this field were reduced. An error will be thrown if you attempt to list an item with invalid business policy settings. See the Release Notes for details.
See the Field Index to learn which calls use returnsWithinOption.

shippingCostPaidByOption ( token ) [0..1]
This option specifies either the buyer or the seller as the party who pays for return shipping charges. Accepted values are Buyer or Seller. eBay sites often set Seller as the default value for this field and sellers are obligated to honor the values that are set for a listing. This value is required if ReturnsAcceptedOption=ReturnsAccepted.

Depending on the Seller's return policy and the specifics of a return, either the buyer or the seller can be responsible for the return shipping costs. Note that the seller is always responsible for return shipping costs for SNAD-related issues.

Use GeteBayDetails (with DetailName=ReturnPolicyDetails) and review the returned ReturnPolicyDetails.ShippingCostPaidBy values to see the values supported by a marketplace.
See the Field Index to learn which calls use shippingCostPaidByOption.

warrantyDurationOption ( token ) [0..1]
This field is deprecated as of v1.1.0 and any values supplied in this field are ignored. eBay no longer supports warranty policies for returns.
See the Field Index to learn which calls use warrantyDurationOption.

warrantyOfferedOption ( token ) [0..1]
This field is deprecated as of v1.1.0 and any values supplied in this field are ignored. eBay no longer supports warranty policies for returns.
See the Field Index to learn which calls use warrantyOfferedOption.

warrantyTypeOption ( token ) [0..1]
This field is deprecated as of v1.1.0 and any values supplied in this field are ignored. eBay no longer supports warranty policies for returns.
See the Field Index to learn which calls use warrantyTypeOption.