eBay Shopping APIVersion 1293
 

ReturnPolicyType

Type used to express the details of the Return Policy that the seller has defined for the listing. Sellers have the ability to create separate return policies for domestic and international returns, but if a seller (who ships internationally) does not set up a separate international return policy, the settings in the domestic return policy fields will also apply to international returns.

Type that uses ReturnPolicyType:

Calls that use ReturnPolicyType:

Fields



Description ( string ) [0..1]
This field contains the seller's detailed explanation for their Return Policy. This same description is displayed in the Return Policy section of the View Item page. A Return Policy description (and this field) is only supported in the following marketplaces:
  • Germany (DE)
  • Spain (ES)
  • France (FR)
  • Italy (IT)
See the Field Index to learn which calls use Description.

EAN ( string ) [0..1]
Not used by any call.

The EAN (European Article Number) value is no longer a part of the Return Policy, so this field is deprecated. Instead, any EAN for a listing is returned in Item Specifics (if IncludeSelector value is set to ItemSpecifics).
See the Field Index to learn which calls use EAN.

InternationalRefund ( string ) [0..1]
This field indicates how the seller compensates international buyers for remorse returns. On many eBay marketplaces, 'Money Back' is the only option for domestic and international returns. The eBay US marketplace also allows sellers to offer buyers a 'Money Back Or Replacement' option, where the seller still wants the item they purchased, and prefers that the seller send an identical replacement item instead of a refund. This will typically happen if the originally purchased item arrived damaged or was missing parts.

Note: If the seller ships internationally, but did not specify a separate international return policy for the listing, this field is not returned, and the refund method in the Refund field will also apply for international returns.
See the Field Index to learn which calls use InternationalRefund.

InternationalReturnsAccepted ( string ) [0..1]
This field is always returned with the ReturnPolicy container if the seller ships items to other countries, even if the seller does not accept returns for the item. If the value of this field is ReturnsNotAccepted, the seller does not accept international returns (except in the case of a defective item or 'significantly not as described' item). If the value of this field is ReturnsAccepted, the seller does accept international returns, and other fields under the ReturnPolicy container will state the length of the international return period, the refund method, and order partner that is responsible for return shipping costs.

Note: If the seller ships internationally, but did not specify a separate international return policy for the listing, this field is not returned, and the 'returns accepted' value in the ReturnsAccepted field will also apply for international returns.
See the Field Index to learn which calls use InternationalReturnsAccepted.

InternationalReturnsWithin ( string ) [0..1]
The value in this field indicates the number of days that an international 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. The return period must be specified by the seller if that seller accepts international returns from countries they ship to (InternationalReturnsAcceptedOption=ReturnsAccepted).

Note: If the seller ships internationally, but did not specify a separate international return policy for the listing, this field is not returned, and the return period in the ReturnsWithin field will also apply for international returns.
See the Field Index to learn which calls use InternationalReturnsWithin.

InternationalShippingCostPaidBy ( string ) [0..1]
This field specifies either the 'Buyer' or the 'Seller' as the party who pays for international return shipping costs. It is up to the seller to decide whether the buyer or seller pays for return shipping costs, but the seller does have an incentive to pay return shipping costs, as the listing will be marked in search results as having 'Free Returns' if the seller pays return shipping costs.

Note that the seller is always responsible for return shipping costs for SNAD-related issues, including defective items.

Note: If the seller ships internationally, but did not specify a separate international return policy for the listing, this field is not returned, and the return shipping cost payee in the ShippingCostPaidBy field will also apply for international returns.
See the Field Index to learn which calls use InternationalShippingCostPaidBy.

Refund ( string ) [0..1]
This field indicates how the seller compensates domestic buyers for remorse returns. On many eBay marketplaces, 'Money Back' is the only option for domestic and international returns. The eBay US marketplace also allows sellers to offer buyers a 'Money Back Or Replacement' option, where the seller still wants the item they purchased, and prefers that the seller send an identical replacement item instead of a refund. This will typically happen if the originally purchased item arrived damaged or was missing parts.

Note: If the seller ships internationally, but did not specify a separate international return policy for the listing, the refund method in this field will also apply for international returns.
See the Field Index to learn which calls use Refund.

RestockingFeeValue ( token ) [0..1]
Not used by any call.

This field is deprecated as of release 1061, and sellers are no longer allowed to charge buyers a restocking fee when returning items.
See the Field Index to learn which calls use RestockingFeeValue.

RestockingFeeValueOption ( token ) [0..1]
Not used by any call.

This field is deprecated as of release 1061 and sellers are no longer allowed to charge buyers a restocking fee when returning items.
See the Field Index to learn which calls use RestockingFeeValueOption.

ReturnsAccepted ( string ) [0..1]
This field is always returned with the ReturnPolicy container, even if the seller does not accept returns for the item. If the value of this field is ReturnsNotAccepted, the seller does not accept domestic returns (except in the case of a defective item or 'significantly not as described' item), and this field may be the only field returned under the ReturnPolicy container. If the value of this field is ReturnsAccepted, the seller does accept domestic returns, and other fields under the ReturnPolicy container will state the length of the return period, the refund method, and order partner that is responsible for return shipping costs.

Note: If the seller ships internationally, but did not specify a separate international return policy for the listing, the 'returns accepted' value in this field will also apply for international returns.
See the Field Index to learn which calls use ReturnsAccepted.

ReturnsWithin ( string ) [0..1]
The value in this field indicates the number of days that a domestic 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. The return period must be specified by the seller if that seller accepts returns (ReturnsAcceptedOption=ReturnsAccepted).

Note: If the seller ships internationally, but did not specify a separate international return policy for the listing, the return period in this field will also apply for international returns.
See the Field Index to learn which calls use ReturnsWithin.

ShippingCostPaidBy ( string ) [0..1]
This field specifies either the 'Buyer' or the 'Seller' as the party who pays for domestic return shipping costs. It is up to the seller to decide whether the buyer or seller pays for return shipping costs, but the seller does have an incentive to pay return shipping costs, as the listing will be marked in search results as having 'Free Returns' if the seller pays return shipping costs.

Note that the seller is always responsible for return shipping costs for SNAD-related issues, including defective items.

Note: If the seller ships internationally, but did not specify a separate international return policy for the listing, the return shipping cost payee in this field will also apply for international returns.
See the Field Index to learn which calls use ShippingCostPaidBy.

WarrantyDuration ( string ) [0..1]
Not used by any call.

This field is deprecated as of release 1061, as sellers are no longer allowed to offer product warranties through the Return Policy.
See the Field Index to learn which calls use WarrantyDuration.

WarrantyOffered ( string ) [0..1]
Not used by any call.

This field is deprecated as of release 1061, as sellers are no longer allowed to offer product warranties through the Return Policy.
See the Field Index to learn which calls use WarrantyOffered.

WarrantyType ( string ) [0..1]
Not used by any call.

This field is deprecated as of release 1061, as sellers are no longer allowed to offer product warranties through the Return Policy.
See the Field Index to learn which calls use WarrantyType.