AddTransactionConfirmationItem

Use this call to end the eBay Motors listing specified by the supplied ItemID and create a new Transaction Confirmation Request (TCR) for the item. This action enables the TCR recipient to purchase the item. Alternatively, you can use this call to see if a new TCR can be created for the specified item.

This call applies to items on the US eBay Motors site (except in the Parts and Accessories category) and can be used with items that have been listed for at least 24 hours. You can use GetCategoryFeatures to confirm if the Transaction Confirmation Request feature is defined for the category you want to use. After you create a TCR, the Item.ListingDetails.TCROriginalItemID field returned by GetItem (as well as by GetSellerList and GetBidderList) indicates the item ID of the original item listing (that is, the item ID of the listing before the TCR was created).

A TCR can be sent by a seller to any one of the following: a bidder, a best offer buyer, a member who has asked the seller a question, or any member with a postal code.

If you use this call to create a new Transaction Confirmation Request (TCR) (rather than to verify whether or not a TCR can be created for the item), an new ItemID value for the TCR is returned in the response.

Test AddTransactionConfirmationItem by setting the VerifyEligibilityOnly field to true. This verifies that a new Transaction Confirmation Request (TCR) can be created for the specified ItemID, rather than actually creating a TCR.

See:
    Learning About Bidders
    Enabling Best Offer

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"?>
<AddTransactionConfirmationItemRequest xmlns="urn:ebay:apis:eBLBaseComponents">
  <!-- Call-specific Input Fields -->
  <Comments> string </Comments>
  <ItemID> ItemIDType (string) </ItemID>
  <ListingDuration> SecondChanceOfferDurationCodeType </ListingDuration>
  <NegotiatedPrice currencyID="CurrencyCodeType"> AmountType (double) </NegotiatedPrice>
  <RecipientPostalCode> string </RecipientPostalCode>
  <RecipientRelationType> RecipientRelationCodeType </RecipientRelationType>
  <RecipientUserID> UserIDType (string) </RecipientUserID>
  <VerifyEligibilityOnly> string </VerifyEligibilityOnly>
  <!-- Standard Input Fields -->
  <ErrorLanguage> string </ErrorLanguage>
  <MessageID> string </MessageID>
  <Version> string </Version>
  <WarningLevel> WarningLevelCodeType </WarningLevel>
</AddTransactionConfirmationItemRequest>

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"?>
<AddTransactionConfirmationItemResponse xmlns="urn:ebay:apis:eBLBaseComponents">
  <!-- Call-specific Output Fields -->
  <EndTime> dateTime </EndTime>
  <ItemID> ItemIDType (string) </ItemID>
  <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>
</AddTransactionConfirmationItemResponse>

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.

Creates a TCR with which a user can purchase an item from eBay Motors.

Description

M******************t listed a classic Rambler station wagon on eBay Motors, and Big Buyer expressed interest in the automobile. M******************t uses AddTransactionConfirmationItem to open a TCR for $12,500 USD, and send Big Buyer an option to purchase the vehicle.

Input

XML format.

<?xml version="1.0" encoding="utf-8"?> 
<AddTransactionConfirmationItemRequest xmlns="urn:ebay:apis:eBLBaseComponents"> 
  <RequesterCredentials> 
    <eBayAuthToken>A*******3</eBayAuthToken> 
  </RequesterCredentials> 
  <RecipientUserID>B******r</RecipientUserID> 
  <VerifyEligibilityOnly>false</VerifyEligibilityOnly> 
  <RecipientPostalCode>95125</RecipientPostalCode> 
  <RecipientRelationType>4</RecipientRelationType> 
  <NegotiatedPrice>12500</NegotiatedPrice> 
  <ListingDuration>Days_3</ListingDuration> 
  <ItemID>2**********2</ItemID> 
  <Comments>You are looking at one Beautiful station wagon!</Comments> 
</AddTransactionConfirmationItemRequest>

Output

XML format.
<?xml version="1.0" encoding="utf-8"?> 
<AddTransactionConfirmationItemResponse xmlns="urn:ebay:apis:eBLBaseComponents"> 
  <Timestamp>2019-11-04T17:11:57.892Z</Timestamp> 
  <Ack>Success</Ack> 
  <Version>1131</Version> 
  <Build>E1131_CORE_API6_19105226_R1</Build> 
  <ItemID>2**********3</ItemID> 
  <StartTime>2019-11-04T00:05:22.120Z</StartTime> 
  <EndTime>2019-11-07T00:05:22.120Z</EndTime> 
</AddTransactionConfirmationItemResponse> 
 

Change History