This root container defines a seller's return business policy for a specific marketplace and category group. This type is used when creating or updating a return business policy.
Types that use ReturnPolicyRequest
Not used by any types.
Calls that use ReturnPolicyRequest
Fields
Note: Return business policies are not applicable to motor vehicle listings, so the categoryTypes.name value must be set to
ALL_EXCLUDING_MOTORS_VEHICLES
for return business policies.Max length: 250
Important! This field is deprecated, since eBay no longer supports extended holiday returns. Any value supplied in this field is neither read nor returned.
Max length: 64
MONEY_BACK
if omitted, so this field is only needed for Buy online, Pickup in Store or Click and Collect items where the seller is willing to offer merchandise credit as an additional refund method to buyers. Getting their money back for returned items is always an option for buyers, regardless of what the seller sets in this field.Important! If this field is not included in a return business policy, it will default to MONEY_BACK
.
Important! This field is deprecated, since eBay no longer allows sellers to charge a restocking fee for buyer remorse returns. If this field is included, it is ignored.
Important! This field is no longer supported on many eBay marketplaces. To see if a marketplace and eBay category does support this field, call getReturnPolicies method of the Metadata API. Then you will look for the policyDescriptionEnabled field with a value of true
for the eBay category.
Max length: 5000 (8000 for DE)
You must set the value to one that's accepted by the marketplace and category where the item is listed. Most categories support 30-day and 60-day return periods.
For a definitive list of return periods for one or more categories, call getReturnPolicies method of the Metadata API.
The return period is set using the TimeDuration type, where you set unit to
DAY
and value to either 30
or 60
(or other value, as appropriate). Note that this value cannot be modified if the listing has bids or sales, or if the listing ends within 12 hours.
Required if returnsAccepted is set to
true
.true
, the seller accepts returns. If set to false
, the seller does not accept returns.Note:Top-Rated sellers must accept item returns and the handlingTime should be set to zero days or one day for a listing to receive a Top-Rated Plus badge on the View Item or search result pages. For more information on eBay's Top-Rated seller program, see Becoming a Top Rated Seller and qualifying for Top Rated Plus benefits.
BUYER
or SELLER
. Depending on the return policy and specifics of the 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.
This field is conditionally required if returnsAccepted is set to
true
.