Skip to main content

This type is used by the returnPolicy response container, a container which defines a seller's return business policy for a specific marketplace.

Type that uses ReturnPolicy

ReturnPolicyResponse

Calls that use ReturnPolicy

Fields

Field
Type
Description
categoryTypes
array of CategoryType
This container indicates which category group that the return policy applies to.

Note: Return business policies are not applicable to motor vehicle listings, so the categoryTypes.name value will always be ALL_EXCLUDING_MOTORS_VEHICLES for return business policies.
description
A seller-defined description of the return business policy. This description is only for the seller's use, and is not exposed on any eBay pages.

Max length: 250
extendedHolidayReturnsOffered

Important! This field is deprecated, since eBay no longer supports extended holiday returns. Any value supplied in this field is neither read nor returned.

internationalOverride
This container shows the seller's international return policy settings. This container is only returned if the seller has set a separate international return policy for the business policies. Interational return policies are optional, even if the seller ships to international locations. If a separate international return policy is not set, all of the domestic return policy settings also apply to international orders.
marketplaceId
The ID of the eBay marketplace to which this return business policy applies.
name
A seller-defined name for this payment business policy. Names must be unique for policies assigned to the same marketplace.

Max length: 64
refundMethod
This value indicates the refund method that will be used by the seller for buyer returns. In most cases, this value is going to be MONEY_BACK, except for 'Click and Collect' and 'Buy Online, Pick up in Store' orders where the seller is able to offer a store/merchandise credit in addition to the 'money back' option. The buyer recieving money back for a return is always an option available to the buyer, even if this field returns MERCHANDISE_CREDIT.
restockingFeePercentage

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 and it is no longer returned.

returnInstructions
This text-based field provides more details on seller-specified return instructions. This field is only returned if set for the return business policy.

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)
returnMethod
This field is only returned if the seller wants to offer an alternative return method other than 'money back', such as an exchange or replacement item.
returnPeriod
This container indicates the number of calendar days that 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 categories support 30-day and 60-day return periods.

Note: Unless the seller has set a separate international return policy through the internationalOverride container, this return period will be valid for domestic and international returns (if the seller ships internationally).
returnPolicyId
A unique eBay-assigned ID for a return business policy. This ID is generated when the policy is created.
returnsAccepted
If this field is returned as true, the seller accepts 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.
returnShippingCostPayer
This field indicates who is responsible for paying for the shipping charges for returned items. The field can be set to either 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.