You can enable a "requestor" (seller or buyer) to leave feedback by using the LeaveFeedback or the CompleteSale call. There must be an order relationship between the users which means the requestor and recipient must have been participants in a successfully concluded listing which concluded no more than 60 days before the attempt to leave feedback. Whichever role the requestor has (i.e., seller or buyer,) the recipient must have been in the opposite role.
Identify the user about whom the feedback is being left in the TargetUser property of LeaveFeedback. This property takes a value of type UserIDType
that is the eBay user name — also called the eBay user ID — for the recipient.
To indicate the order relationship between the requestor and the recipient, specify the item ID for the successfully concluded listing in the ItemID property.
If the listing offered only a single item (i.e., an auction listing or a single-item, fixed-price listing,) this item ID is enough to identify the order line item associating the two users. This is because such listings can only spawn one order line item. But a multi-item, fixed-price listing has the potential for spawning multiple order line items, up to the number of items offered in the listing. In these cases, the application must specify the ItemID/TransactionID pair or the OrderLineItemID for that particular order line item. Specify the TransactionID in the TransactionID property, which is of type string
. TransactionID is optional, unless the listing for the feedback is a multi-item listing when it is a required input.
The feedback itself consists of a score and a comment that expands on or justifies the score. Specify the feedback score — positive, neutral, or negative — in the CommentType property. CommentType is of type CommentTypeCodeType
, with valid input values of Positive
, Neutral
, and Negative
. Specify a textual comment for the feedback in the CommentText property (type string
).
LeaveFeedback can be used to leave one feedback. It cannot be used to leave multiple feedbacks even when the requestor is the seller in a multi-item listing and the recipients all buyers from that same listing. To leave multiple feedbacks, an application needs to use LeaveFeedback once for each feedback.
Some feedback restrictions apply to protect members from receiving false or inaccurate feedback from other members:
- Sellers are not able to leave negative or neutral feedback for buyers.
- Buyers are not able to leave neutral or negative feedback for sellers within 7 days of the order line item creation.
- Any neutral or negative feedback left by suspended members' will not count.
- Any neutral or negative feedback left by a buyer who has not responded to a UPI dispute will not count.
- All feedback (negative, neutral, and positive) left by a buyer for a seller will be removed if that seller wins an eBay Buyer Protection case against the buyer for that order line item.
An application can give the appearance of letting the end-user leave multiple feedbacks in batches. This is done by allowing the end-user to enter the data for as many feedbacks as desired, perhaps store the information in a database. When the user clicks a button, LeaveFeedback is executed once for each pending feedback.
The result set of LeaveFeedback includes FeedbackID, which is the ID of the feedback that has been left. The response object also contains the fields "inherited" from the abstract response object, such as the field with the date and time the call was made.