eBay Trading APIVersion 1475
 

ReturnPolicyDetailsType

Note: This type is used by the deprecated ReturnPolicyDetails container that may still be returned in GeteBayDetails. For category-specific return-policy metadata, use the Sell Metadata API getReturnPolicies method. This method returns category-level domestic and international return-policy metadata for the applicable leaf category, including policyDescriptionEnabled, refundMethods, returnsAcceptanceEnabled, returnPeriods, and returnShippingCostPayers.

Type that uses ReturnPolicyDetailsType:

Call that uses ReturnPolicyDetailsType:

Fields



Description ( boolean ) [0..1]
Note: This field is used by the deprecated ReturnPolicyDetails container returned in GeteBayDetails. For category-specific support, call getReturnPolicies and inspect the returnPolicies.domestic.policyDescriptionEnabled and returnPolicies.international.policyDescriptionEnabled fields for the target marketplace and category. </span>
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.

Note: This type defines the deprecated ReturnPolicyDetails.Refund container that may still be returned in GeteBayDetails. To determine which refund methods are supported for a specific leaf category on a specific eBay marketplace, call the getReturnPolicies method and inspect the returnPolicies.domestic.refundMethods and returnPolicies.international.refundMethods fields. When using legacy Trading API ReturnPolicy fields, use RefundOption and InternationalRefundOption to pass one of the supported values returned by getReturnPolicies. If MONEY_BACK is returned by getReturnPolicies, use MoneyBack in RefundOption and InternationalRefundOption.
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..*]
Note: This type defines the deprecated ReturnPolicyDetails.ReturnsAccepted container that may still be returned in GeteBayDetails. To determine whether returns are supported for a specific leaf category on a specific eBay marketplace, call getReturnPolicies and inspect the returnPolicies.domestic.returnsAcceptanceEnabled and returnPolicies.international.returnsAcceptanceEnabled fields. When using legacy Trading API ReturnPolicy fields, use ReturnsAcceptedOption and InternationalReturnsAcceptedOption to indicate whether or not the seller accepts returns for categories where return policies are applicable. Note that not accepting returns is still a valid return policy.
See the Field Index to learn which calls use ReturnsAccepted.

ReturnsWithin ( ReturnsWithinDetailsType ) [0..*]


Note: This type defines the deprecated ReturnPolicyDetails.ReturnsWithin container that may still be returned in GeteBayDetails. To determine which return periods are supported for a specific leaf category on a specific eBay marketplace, call getReturnPolicies and inspect the returnPolicies.domestic.returnPeriods and returnPolicies.international.returnPeriods fields. When using legacy Trading API ReturnPolicy fields, use ReturnsWithinOption and InternationalReturnsWithinOption to pass one of the supported values returned by getReturnPolicies. For example, if getReturnPolicies returns a returnPeriods.value of 30, use Days_30 in ReturnsWithinOption or InternationalReturnsWithinOption.
See the Field Index to learn which calls use ReturnsWithin.

ShippingCostPaidBy ( ShippingCostPaidByDetailsType ) [0..*]
This type defines the deprecated ReturnPolicyDetails.ShippingCostPaidBy container that may still be returned in GeteBayDetails. This value indicates whether the buyer or seller is responsible for return shipping cost. For category-specific support, call the Sell Metadata API getReturnPolicies and inspect the returnPolicies.domestic.returnShippingCostPayers and returnPolicies.international.returnShippingCostPayers fields for the target marketplace and category. When using legacy Trading API ReturnPolicy fields, use ShippingCostPaidByOption and InternationalShippingCostPaidByOption to pass one of the supported values returned by getReturnPolicies. Note that for SNAD returns, the seller is always responsible for return shipping cost.
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.