eBay Trading APIVersion 1375
 

ReturnPolicyDetailsType

Type defining the ReturnPolicyDetails container, which is returned in GeteBayDetails, and provides the seller with the Return Policy features (and applicable values) that are supported by the listing site. This container is only returned if ReturnPolicyDetails is included as a DetailName filter in the call request, or if no DetailName filters are used in the request.

Note: The GeteBayDetails call returns site-default Return Policy settings. For most categories within a given eBay site, the supported Return Policy options/values are the same, but there a few exceptions. To discover what Return Policy features/settings that a particular category supports, call GetCategoryFeatures and include any or all of the domestic and or international Return Policy-related FeatureID values to see the Return Policy features/settings available for domestic and international returns, respectively.

Type that uses ReturnPolicyDetailsType:

Call that uses ReturnPolicyDetailsType:

Fields



Description ( boolean ) [0..1]
This field is returned with a value of true if the site supports a text description of the seller's Return Policy in listings. If the site does support a text description of the seller's Return Policy, it is set through the ReturnPolicy.Description field in an Add/Revise/Relist API call. Currently, the only eBay sites that support Return Policy descriptions are Germany, Austria, France, Italy, and Spain.

Note: To discover if a Return Policy desciption is supported by a particular category, call GetCategoryFeatures and include ReturnPolicyDescriptionEnabled as a FeatureID value to see if the category supports the use of a Return Policy description.
See the Field Index to learn which calls use Description.

DetailVersion ( string ) [0..1]
Returns the latest version number for the Return Policy Details metadata set. The version can be used to determine if and when to refresh cached client data.
See the Field Index to learn which calls use DetailVersion.

This container consists of the supported refund/exchange/replacement item options that the seller may make available to the buyer in case the buyer wants to return the original item. Enumeration value(s) returned in RefundOption field(s) can be used in the ReturnPolicy.RefundOption field in an Add/Revise/Relist API call.

Note: To discover what refund options that a particular category supports, call GetCategoryFeatures and include DomesticRefundMethodValues and/or InternationalRefundMethodValues as FeatureID values to see the refund options available for domestic and international returns, respectively.
See the Field Index to learn which calls use Refund.

RestockingFeeValue ( RestockingFeeValueDetailsType ) [0..*]
Not used by any call.

This type is deprecated, as sellers are no longer allowed to set a restocking fee through a listings's return policy.
See the Field Index to learn which calls use RestockingFeeValue.

ReturnsAccepted ( ReturnsAcceptedDetailsType ) [0..*]
This container consists of the enumeration values that can be passed into the ReturnPolicy.ReturnsAcceptedOption field when using an Add/Revise/Relist API call. This value will indicate whether or not the seller allows the buyer to return the item.

Note: To discover the enumeration values that a particular category supports, call GetCategoryFeatures and include DomesticReturnsAcceptedValues and/or InternationalReturnsAcceptedValues as FeatureID values to see the ReturnPolicy.ReturnsAcceptedOption and ReturnPolicy.InternationalReturnsAcceptedOption values supported for domestic and international returns, respectively.
See the Field Index to learn which calls use ReturnsAccepted.

ReturnsWithin ( ReturnsWithinDetailsType ) [0..*]
This container consists of the supported time periods within which the buyer can return the item, starting from the day they receive the item. Enumeration value(s) returned in ReturnsWithinOption field(s) can be used in the ReturnPolicy.ReturnsWithinOption field in an Add/Revise/Relist API call.

Note: To discover what return durations that a particular category supports, call GetCategoryFeatures and include DomesticReturnsDurationValues and/or InternationalReturnsDurationValues as FeatureID values to see the return durations available for domestic and international returns, respectively.
See the Field Index to learn which calls use ReturnsWithin.

ShippingCostPaidBy ( ShippingCostPaidByDetailsType ) [0..*]
This container consists of the enumeration values that can be passed into the ReturnPolicy.ShippingCostPaidByOption or ReturnPolicy.InternationalShippingCostPaidByOption field when using an Add/Revise/Relist API call. This value will indicate whether the buyer or seller is responsible for return shipping cost. The enumeration value(s) returned in ShippingCostPaidByOption field(s) can be used in the ReturnPolicy.ShippingCostPaidByOption field in an
See the Field Index to learn which calls use ShippingCostPaidBy.

UpdateTime ( dateTime ) [0..1]
This timestamp in GMT indicate when the Return Policy Details metadata were last updated. This timestamp can be used to determine if and when to refresh cached client data.
See the Field Index to learn which calls use UpdateTime.