{ "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "#/components/schemas/SetReturnPolicyResponse", "title": "SetReturnPolicyResponse", "type": "object", "properties": { "categoryTypes": { "type": "array", "description": "This field always returns ALL_EXCLUDING_MOTORS_VEHICLES for return business policies, since return business policies are not applicable to motor vehicle listings.", "items": { "$ref": "#/components/schemas/CategoryType" } }, "description": { "type": "string", "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. This field is returned if set for the policy.

Max length: 250" }, "extendedHolidayReturnsOffered": { "type": "boolean", "description": "

Important! This field is deprecated, since eBay no longer supports extended holiday returns. This field should no longer be returned.

" }, "internationalOverride": { "description": "This container is used by the seller to specify a separate international return policy, and will only be returned if the seller has set a separate return policy for international orders. If a separate international return policy is not defined by a seller, all of the domestic return policy settings will also apply to international orders.", "$ref": "#/components/schemas/InternationalReturnOverrideType" }, "marketplaceId": { "type": "string", "description": "The ID of the eBay marketplace to which this return business policy applies. For implementation help, refer to eBay API documentation" }, "name": { "type": "string", "description": "A seller-defined name for this return business policy. Names must be unique for policies assigned to the same marketplace.

Max length: 64" }, "refundMethod": { "type": "string", "description": "If a seller indicates that they will accept buyer returns, this value will be MONEY_BACK. For implementation help, refer to eBay API documentation" }, "restockingFeePercentage": { "type": "string", "description": "

Important! This field is deprecated, since eBay no longer allows sellers to charge a restocking fee for buyer remorse returns.

" }, "returnInstructions": { "type": "string", "description": "This text-based field provides more details on seller-specified return instructions.

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": { "type": "string", "description": "This field will be returned if the seller is willing and able to offer a replacement item as an alternative to 'Money Back'. For implementation help, refer to eBay API documentation" }, "returnPeriod": { "description": "This container specifies the amount of days that the buyer has to return the item after receiving it. The return period begins when the item is marked \"delivered\" at the buyer's specified ship-to location. This container will be returned unless the business policy states that the seller does not accept returns.", "$ref": "#/components/schemas/TimeDuration" }, "returnPolicyId": { "type": "string", "description": "A unique eBay-assigned ID for a return business policy. This ID is generated when the policy is created." }, "returnsAccepted": { "type": "boolean", "description": "If set to true, the seller accepts returns. If set to false, this field indicates that the seller does not accept returns." }, "returnShippingCostPayer": { "type": "string", "description": "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.

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

This container will be returned unless the business policy states that the seller does not accept returns. For implementation help, refer to eBay API documentation" }, "warnings": { "type": "array", "description": "An array of one or more errors or warnings that were generated during the processing of the request. If there were no issues with the request, this array will return empty.", "items": { "$ref": "#/components/schemas/Error" } } }, "description": "A complex type that is populated with a response containing a return policies." }