VerifyAddSecondChanceItem

Use this call to test the inputs for AddSecondChanceItem without actually extending the second chance offer.

Use VerifyAddSecondChanceItem to test extending a second-chance offer to a non-winning bidder from a specified ended listing. This call tests the inputs that you would use with AddSecondChanceItem, but it does not actually extend the second chance offer (no new listing is created and no notification email is sent to the recipient user).

The requestor must be the seller for the original item listing that is specified in the ItemID property; users are not allowed to create second chance offers for other users' items.

If the call to VerifyAddSecondChanceItem is successful, it returns the start and end times for the mock second-chance offer. See AddSecondChanceItem for details on making second-chance offers.

You can test this call in the Sandbox environment. Make sure the test user has sufficient feedback and other qualifications to list the desired type of item.

See Second chance offers.

See also the reference documentation for these calls:

• GetAllBidders - This call is used to retrieve bidders from an active or recently-ended auction listing.
• AddSecondChanceItem - Used by the seller of an auction listing to provide a Second Chance Offer to one of that auction item's non-winning bidders.

Input

See also Samples.

The box below lists all fields that could be included in the call request. To learn more about an individual field or its type, click its name in the box (or scroll down to find it in the table below the box).

See also the Deprecated Objects link above. Fields presented in this color are deprecated, and fields presented in this color are (or soon will be) non-operational.

The XML prototype does not include requester credentials. This is a documentation limitation only (see Standard Requester Credentials for Making Calls).

<?xml version="1.0" encoding="utf-8"?>
<VerifyAddSecondChanceItemRequest xmlns="urn:ebay:apis:eBLBaseComponents">
  <!-- Call-specific Input Fields -->
  <BuyItNowPrice> AmountType (double) </BuyItNowPrice>
  <Duration> SecondChanceOfferDurationCodeType </Duration>
  <ItemID> ItemIDType (string) </ItemID>
  <RecipientBidderUserID> UserIDType (string) </RecipientBidderUserID>
  <SellerMessage> string </SellerMessage>
  <!-- Standard Input Fields -->
  <ErrorLanguage> string </ErrorLanguage>
  <MessageID> string </MessageID>
  <Version> string </Version>
  <WarningLevel> WarningLevelCodeType </WarningLevel>
</VerifyAddSecondChanceItemRequest>

Output

See also Samples.

The box below lists all fields that might be returned in the response. To learn more about an individual field or its type, click its name in the box (or scroll down to find it in the table below the box).

See also the Deprecated Objects link above. Fields presented in this color are deprecated, and fields presented in this color are not returned (or soon will not be returned) or are not operational (or soon will be non-operational).

<?xml version="1.0" encoding="utf-8"?>
<VerifyAddSecondChanceItemResponse xmlns="urn:ebay:apis:eBLBaseComponents">
  <!-- Call-specific Output Fields -->
  <EndTime> dateTime </EndTime>
  <StartTime> dateTime </StartTime>
  <!-- Standard Output Fields -->
  <Ack> AckCodeType </Ack>
  <Build> string </Build>
  <CorrelationID> string </CorrelationID>
  <Errors> ErrorType
    <ErrorClassification> ErrorClassificationCodeType </ErrorClassification>
    <ErrorCode> token </ErrorCode>
    <ErrorParameters ParamID="string"> ErrorParameterType
      <Value> string </Value>
    </ErrorParameters>
    <!-- ... more ErrorParameters nodes allowed here ... -->
    <LongMessage> string </LongMessage>
    <SeverityCode> SeverityCodeType </SeverityCode>
    <ShortMessage> string </ShortMessage>
  </Errors>
  <!-- ... more Errors nodes allowed here ... -->
  <HardExpirationWarning> string </HardExpirationWarning>
  <Timestamp> dateTime </Timestamp>
  <Version> string </Version>
</VerifyAddSecondChanceItemResponse>

Detail Controls

DetailLevel

This call does not support varying Detail Levels. You do not need to pass DetailLevel in the request.

Samples

New to making API calls? Please see Making a Call.

Note: Some item IDs, user IDs, or other data in these samples might no longer be active on eBay. If necessary, you can substitute current eBay data in your requests.

Tests the creation of a second-chance offer for an item's bidder.

Description

This examples tests the creation of a Second Chance Offer for the one of the non-winning bidders of an ended item.

A prospective buyer (b************r) placed an offer on a book, but did not win the auction. The seller, m***************r, had an identical copy of the book, and wants to extend an offer to b************r to purchase the book. The offer is good for five days.

Input

XML format.

<?xml version="1.0" encoding="utf-8"?>
<VerifyAddSecondChanceItemRequest xmlns="urn:ebay:apis:eBLBaseComponents">
  <RequesterCredentials>
    <eBayAuthToken>A*******3</eBayAuthToken>
  </RequesterCredentials>
  <ItemID>1**********1</ItemID>
  <RecipientBidderUserID>b************r</RecipientBidderUserID>
  <Duration>Days_5</Duration>
</VerifyAddSecondChanceItemRequest>

Output

XML format.
<VerifyAddSecondChanceItemResponse xmlns="urn:ebay:apis:eBLBaseComponents">
  <Timestamp>2019-11-07T18:51:07.644Z</Timestamp>
  <Ack>Success</Ack>
  <Version>1131</Version>
  <Build>E1131_UNI_API5_19098188_R1</Build>
  <StartTime>2019-11-07T18:51:07.644Z</StartTime>
  <EndTime>2019-11-12T18:51:07.644Z</EndTime>
</VerifyAddSecondChanceItemResponse>

Change History