eBay Trading API Call Reference Version 579 Support     Knowledge Base     Forums     All Tutorials     All Code Samples Trading API Guide Call Reference Making an API Call Tutorials Release Notes

List of All Calls Field Index Enumeration Index Type Index Deprecated Objects Errors by Number Input Output Detail Controls Samples Change History Top Errors for PlaceOffer User Notes

Enables a user to bid (make an offer) on an item or make a best offer. For competitive-bidding listings (Chinese and Dutch auctions), a user can make a bid. For fixed-price listings (Basic Fixed-Price and eBay Stores Inventory listings), a user can purchase an item. A user can make a best offer on an item for which Best Offer is enabled. For information about the Best Offer feature (including rules for counteroffers), see Enabling Best Offer.

For more information about each use of PlaceOffer (including information about making a best offer or counteroffer, and information about accepting or declining a counteroffer), please see PlaceOffer Input.

Important note: Before using this call, please carefully review the PlaceOffer Policies and Guidelines. The PlaceOffer Policies are required for use of PlaceOffer in the production environment. Please carefully write your application to follow all the PlaceOffer Policies.

Note: PlaceOffer is available for evaluation by all in the Sandbox (test) environment.

For information about becoming authorized to use PlaceOffer in the Production environment, please contact Developer Relations, developer-relations@ebay.com.

Important notes: When you use PlaceOffer to make a best offer, no affiliate-related commissions are paid. Affiliate-commission functionality is not available in the Sandbox environment. Affiliate commissions from PlaceOffer require that the call be made to the site on which the item is listed. Affiliate commissions from PlaceOffer also require that the affiliate has signed up with the eBay Partner Network for the site on which the item is listed.

If you make a PlaceOffer request and eBay returns a BotBlock container, your application must use the contents of the BotBlock container to show that the application-user is a human and not a bot.

Capture the contents of the BotBlock container (BotBlockUrl, BotBlockAudioUrl, and BotBlockToken) returned by PlaceOffer. The application-user must input the value for BotBlockUrl or BotBlockAudioUrl. Your application must capture this value and, in the next PlaceOffer call, include a BotBlock container (containing the user-input value and the token you captured from the BotBlockToken field). eBay then uses your BotBlock container (in your second PlaceOffer call) to validate that the user is a human and not a bot.

You can use GetChallengeToken to test your application's ability to show that a PlaceOffer user is a human and not a bot. Make a GetChallengeToken request and capture ChallengeToken, ImageChallengeURL, and AudioChallengeURL. The application-user must input the value for ImageChallengeURL or AudioChallengeURL. Your application must capture this value and, in a PlaceOffer call, include a BotBlock container. The BotBlock container will contain the user-input value along with the value from ChallengeToken (from the GetChallengeToken response). eBay then uses your BotBlock container to validate that the user is a human and not a bot.

If PayPal is the required payment method, then the user making a bid or purchase must have a PayPal account.

If a user has placed a bid on an item with Bid Assistant (available on the eBay site), then a subsequent PlaceOffer call on behalf of that user, on that item, will not succeed.

See PlaceOffer.

Related calls:

• GetChallengeToken - Retrieves a botblock token and URLs for an image or audio clip that the user is to match.
• GetBestOffers - Retrieves the best offers associated with an ItemID according to the BestOfferStatus filter, where Active is the default value. Specify a best offer ID to retrieve the details for a specific best offer.

Back to top

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 Samples.

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 may be missing some XML fields and attributes. This is a documentation limitation only (see Limitations of This Document).

<?xml version="1.0" encoding="utf-8"?>
<PlaceOfferRequest xmlns="urn:ebay:apis:eBLBaseComponents">
  <!-- Standard Input Fields -->
  <BotBlock> BotBlockRequestType 
    <BotBlockToken> string </BotBlockToken>
    <BotBlockUserInput> string </BotBlockUserInput>
  </BotBlock>
  <EndUserIP> string </EndUserIP>
  <ErrorLanguage> string </ErrorLanguage>
  <InvocationID> UUIDType (string) </InvocationID>
  <MessageID> string </MessageID>
  <Version> string </Version>
  <WarningLevel> WarningLevelCodeType </WarningLevel>
  <!-- Call-specific Input Fields -->
  <AffiliateTrackingDetails> AffiliateTrackingDetailsType 
    <AffiliateUserID> string </AffiliateUserID>
    <ApplicationDeviceType> ApplicationDeviceTypeCodeType </ApplicationDeviceType>
    <TrackingID> string </TrackingID>
    <TrackingPartnerCode> string </TrackingPartnerCode>
  </AffiliateTrackingDetails>
  <BlockOnWarning> boolean </BlockOnWarning>
  <ItemID> ItemIDType (string) </ItemID>
  <Offer> OfferType 
    <Action> BidActionCodeType </Action>
    <BestOfferID> BestOfferIDType (string) </BestOfferID>
    <MaxBid> AmountType (double) </MaxBid>
    <Message> string </Message>
    <Quantity> int </Quantity>
    <UserConsent> boolean </UserConsent>
  </Offer>
</PlaceOfferRequest>

Back to top

The box below lists all fields that might be returned in the call 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 Samples.

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).

The XML prototype may be missing some XML fields and attributes. This is a documentation limitation only (see Limitations of This Document).

<?xml version="1.0" encoding="utf-8"?>
<PlaceOfferResponse xmlns="urn:ebay:apis:eBLBaseComponents">
  <!-- Standard Output Fields -->
  <Ack> AckCodeType </Ack>
  <BotBlock> BotBlockResponseType 
    <BotBlockAudioUrl> string </BotBlockAudioUrl>
    <BotBlockToken> string </BotBlockToken>
    <BotBlockUrl> string </BotBlockUrl>
  </BotBlock>
  <Build> string </Build>
  <CorrelationID> string </CorrelationID>
  <DuplicateInvocationDetails> DuplicateInvocationDetailsType 
    <DuplicateInvocationID> UUIDType (string) </DuplicateInvocationID>
    <InvocationTrackingID> string </InvocationTrackingID>
    <Status> InvocationStatusType </Status>
  </DuplicateInvocationDetails>
  <Errors> ErrorType 
    <ErrorClassification> ErrorClassificationCodeType </ErrorClassification>
    <ErrorCode> token </ErrorCode>
    <ErrorParameters ParamID="string"> ErrorParameterType 
      <Value> string </Value>
    </ErrorParameters>
    <!-- ... more ErrorParameters nodes here ... -->
    <LongMessage> string </LongMessage>
    <SeverityCode> SeverityCodeType </SeverityCode>
    <ShortMessage> string </ShortMessage>
  </Errors>
  <!-- ... more Errors nodes here ... -->
  <HardExpirationWarning> string </HardExpirationWarning>
  <Message> string </Message>
  <Timestamp> dateTime </Timestamp>
  <Version> string </Version>
  <!-- Call-specific Output Fields -->
  <BestOffer> BestOfferType 
    <BestOfferID> BestOfferIDType (string) </BestOfferID>
    <Status> BestOfferStatusCodeType </Status>
  </BestOffer>
  <SellingStatus> SellingStatusType 
    <ConvertedCurrentPrice currencyID="CurrencyCodeType"> AmountType (double) </ConvertedCurrentPrice>
    <CurrentPrice currencyID="CurrencyCodeType"> AmountType (double) </CurrentPrice>
    <HighBidder> UserType 
      <UserID> UserIDType (string) </UserID>
    </HighBidder>
    <MinimumToBid currencyID="CurrencyCodeType"> AmountType (double) </MinimumToBid>
    <ReserveMet> boolean </ReserveMet>
  </SellingStatus>
  <TransactionID> string </TransactionID>
</PlaceOfferResponse>

Back to top

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

Back to top

An inline sample will be added in a future release. Please refer to the Samples section of the eBay Web Services Guide chapter for PlaceOffer.

Back to top

Back to top

This document was generated with a customized version of the apireferencedocs tool [0.5M zip].

© 2005–2008 eBay, Inc. All rights reserved.