eBay Business Policies Management APIVersion 1.0.0
 

InternationalReturnPolicyInfo

Populate this complex object if your international return policy differs from your domestic return policy (by default, international return policies inherit their settings from the settings in the domestic return policy).

For example, you might want to offer free returns for domestic shipments, but have a return policy where the buyer pays for returns from non-domestic regions.

Type that uses InternationalReturnPolicyInfo:

Calls that use InternationalReturnPolicyInfo:

Fields

refundOption ( token ) [0..1]
This field indicates how the seller compensates buyers for remorse returns. You must set this value to MoneyBack for all eBay marketplaces except for the US marketplace. This value is required for international returns when ReturnsAcceptedOption=ReturnsAccepted.

Depending on the Seller's return policy and the specifics of a return, either the buyer or the seller can be responsible for the return shipping costs.

On EBAY_US: You can set this value to either MoneyBack or MoneyBackOrReplacement. If a seller has the depth of inventory to support an exchange for an identical item, you can set MoneyBackOrReplacement. Otherwise, eBay recommends you set this value to its default value, MoneyBack.
See the Field Index to learn which calls use refundOption.

returnsAcceptedOption ( token ) [0..1]
This optional field indicates whether or not the seller accepts international returns (returns that need to be shipped via an international shipping service).

Applicable values are ReturnsAccepted or ReturnsNotAccepted. When set to ReturnsAccepted, this option indicates the seller allows international returns. If the seller does not accept international returns, they can specify ReturnsNotAccepted.

On the eBay DE, IE, and UK, registered business sellers must accept returns for fixed-price items (including auction items with Buy It Now and any other fixed price formats) when the category requires a return policy. On some European sites, such as eBay Germany (DE), registered business sellers are required to accept returns. Use the Trading call GetUser to determine the status of an eBay business seller in DE, IE, and UK. Review the User.SellerInfo.SellerBusinessType field in the response.
See the Field Index to learn which calls use returnsAcceptedOption.

returnsWithinOption ( token ) [0..1]
Specifies the amount of time 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 marketplaces and categories support 30-day and 60-day return periods. eBay sites often set 30-days as the default value for this field and sellers are obligated to honor the values that are set for a listing. This value is required for international returns when ReturnsAcceptedOption=ReturnsAccepted.

Applicable values: Retrieve the values supported by a marketplace by calling GeteBayDetails with DetailName set to ReturnPolicyDetails, then review ReturnPolicyDetails.ReturnsWithin.ReturnsWithinOption in the response.
See the Field Index to learn which calls use returnsWithinOption.

shippingCostPaidByOption ( token ) [0..1]
This option specifies either the buyer or the seller as the party who pays for return shipping charges for international returns. Accepted values are Buyer or Seller. This value is required for international returns when ReturnsAcceptedOption=ReturnsAccepted.

Depending on the Seller's return policy and the specifics of a 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.

Use GeteBayDetails (with DetailName=ReturnPolicyDetails) and review the returned ReturnPolicyDetails.ShippingCostPaidBy values to see the values supported by a marketplace.
See the Field Index to learn which calls use shippingCostPaidByOption.