eBay Trading APIVersion 1349
 

AddSecondChanceItemRequestType ( AbstractRequestType )

Used by the seller of an auction listing to provide a Second Chance Offer to one of that auction item's non-winning bidders. A Second Chance Offer is used by sellers whenever the seller was unable to complete the sale with the winning bidder because the bidder didn't pay, or if the auction listing ended without the Reserve Price being met, or if that seller has multiple identical items for sale and wants to give other bidders a chance to purchase the item.

To get information on the bidders for a recently-ended auction listing, the seller can use the GetAllBidders call and pass the corresponding ItemID value into the call request.

For more information on the specifics of Second Chance Offers, see the Making a Second Chance Offer help page.

Call that uses AddSecondChanceItemRequestType:

Fields



BuyItNowPrice ( AmountType (double) ) [0..1]
The amount the offer recipient must pay to purchase the item as a Second Chance Offer. This field should only be used when the original item was listed in an eBay Motors vehicle category (or in some categories on U.S. and international sites for high-priced items, such as items in many U.S. and Canada Business and Industrial categories) and it ended unsold because the reserve price was not met. Otherwise, eBay establishes the price and no price should be submitted. The price offered to the Second Chance Offer recipient is generally the highest bid that the user made on the original listing.
See the Field Index to learn which calls use BuyItNowPrice.

This enumeration value indicates the length of time (in days) that the Second Chance Offer will be available to the recipient. Upon receiving the Second Chance Offer, the recipient bidder will have this many days to accept the offer before the offer expires. One of the values in SecondChanceOfferDurationCodeType must be used.
See the Field Index to learn which calls use Duration.

ItemID ( ItemIDType (string) ) [0..1]
This field is used to identify the original auction listing through its unique identifier (Item ID). Upon a successful call, the Second Chance Offer will be identified by a new ItemID in the response.
See the Field Index to learn which calls use ItemID.

RecipientBidderUserID ( UserIDType (string) ) [0..1]
This field is used to specify the bidder that is being offered the Second Chance Offer. The eBay User ID of the bidder is used in this field. Specify only one RecipientBidderUserID per call. If multiple users are specified, only the last one specified receives the offer. User ID values will be returned in the Offer.User.UserID field of the GetAllBidders call response.
See the Field Index to learn which calls use RecipientBidderUserID.

SellerMessage ( string ) [0..1]
This optional field is used to provide a message to the recipient of the Second Chance Offer. This message cannot contain HTML, asterisks, or quotes. The content in this field will be included in the Second Chance Offer email that is sent to the recipient.
See the Field Index to learn which calls use SellerMessage.