{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "#/components/schemas/RefundItem",
"title": "RefundItem",
"type": "object",
"properties": {
"refundAmount": {
"description": "This container is used to specify the amount of the refund for the corresponding order line item. If a seller wants to issue a refund for an entire order, the seller would use the orderLevelRefundAmount container instead.",
"$ref": "#/components/schemas/SimpleAmount"
},
"lineItemId": {
"type": "string",
"description": "The unique identifier of an order line item. This identifier is created once a buyer purchases a 'Buy It Now' item or if an auction listing ends with a winning bidder.
Either this field or the legacyReference container is needed to identify an individual order line item that will receive a refund.
This value is returned using the getOrders method."
},
"legacyReference": {
"description": "This container is needed if the seller is issuing a refund for an individual order line item, and wishes to use an item ID/transaction ID pair to identify the order line item.
Either this container or the lineItemId field is needed to identify an individual order line item that will receive a refund.
Note: This container should only be used if a seller is using the GetOrders method of the Trading API.",
"$ref": "#/components/schemas/LegacyReference"
}
},
"description": "This type is used if the seller is issuing a refund for one or more individual order line items in a multiple line item order. Otherwise, the seller just uses the orderLevelRefundAmount container to specify the amount of the refund for the entire order."
}