Skip to main content

The CounterOfferReceived notification is sent to a subscribing buyer when a seller makes a counter offer to the buyer's Best Offer. This notification is applicable to Best Offer-enabled listings. The typical flow of events is:

  • A buyer subscribes to the CounterOfferReceived notification.
  • The buyer receives a counteroffer from a seller in response to a Best Offer the buyer placed.
  • eBay sends the CounterOfferReceived notification to the buyer, indicating the buyer received a counteroffer from the seller.

Data Fields Returned

API Call that displays this notification: GetBestOffers with ReturnAll detail level

The data fields returned by the CounterOfferReceived notification are the same as those returned by GetBestOfferResponse with ReturnAll details requested. Refer to the GetBestOffers call reference documentation for additional information.

Refer to SOAP Message Body for information about the standard elements returned for all notifications.

Example

Sample CounterOfferReceived Notification

<?xml version="1.0" encoding="utf-8"?>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://
www.w3.org/2001/XMLSchema" xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance">
  <soapenv:Header>
    <ebl:RequesterCredentials soapenv:mustUnderstand="0" xmlns:ns="urn:ebay:apis:eBLBaseComponents"
xmlns:ebl="urn:ebay:apis:eBLBaseComponents">
      <ebl:NotificationSignature xmlns:ebl="urn:ebay:apis:eBLBaseComponents">fbKLYvy5DGxXn1P8v0mSuw==</
ebl:NotificationSignature>
    </ebl:RequesterCredentials>
  </soapenv:Header>
  <soapenv:Body>
    <GetBestOffersResponse xmlns="urn:ebay:apis:eBLBaseComponents">
      <Timestamp>2008-02-13T03:21:32.606Z</Timestamp>
      <Ack>Success</Ack>
      <CorrelationID>1********0</CorrelationID>
      <Version>553</Version>
      <Build>20050429131630</Build>
      <NotificationEventName>CounterOfferReceived</NotificationEventName>
      <RecipientUserID>B********1</RecipientUserID>
      <BestOfferArray>
        <BestOffer>
          <BestOfferID>6********8</BestOfferID>
          <ExpirationTime>2008-02-15T03:21:19.000Z</ExpirationTime>
          <Buyer>
            <Email>b********r@********.com</Email>
            <FeedbackScore>1</FeedbackScore>
            <RegistrationDate>2004-02-23T23:50:13.000Z</RegistrationDate>
            <UserID>B********1</UserID>
          </Buyer>
          <Price currencyID="USD">200.0</Price>
          <Status>Pending</Status>
          <Quantity>1</Quantity>
          <BestOfferCodeType>SellerCounterOffer</BestOfferCodeType>
        </BestOffer>
      </BestOfferArray>
      <Item>
        <BuyItNowPrice currencyID="USD">1000.0</BuyItNowPrice>
        <ItemID>2********7</ItemID>
        <ListingDetails>
          <EndTime>2008-02-18T03:20:32.000Z</EndTime>
        </ListingDetails>
        <Location>S********A</Location>
        <Title>Test CounterOfferReceived</Title>
      </Item>
    </GetBestOffersResponse>
  </soapenv:Body>
</soapenv:Envelope>