Skip to main content
Published: October 14 2008, 5:29:00 PMUpdated: August 08 2022, 1:52:02 PM

Question

I see an EndOfAuction notification.  How do I receive notifications when my FixedPriceItem item ends?

Answer

You can subscribe to ItemClosed notification which is triggered  when a fixed-price listing ends with or without sales. ItemClosed notification is also sent out when an auction listing ends with no winning bidder.

Here's how to receive ItemClosed notifications when a FixedPriceTransaction item expires (end time reached) or when the item is ended via the EndItem API call.

Call SetNotificationPreferences at the application level

<?xml version="1.0" encoding="utf-8"?>
<SetNotificationPreferencesRequest xmlns="urn:ebay:apis:eBLBaseComponents">
  <Version>1127</Version>
  <ApplicationDeliveryPreferences>
    <ApplicationURL>https://m****************.com</ApplicationURL>  
    <ApplicationEnable>Enable</ApplicationEnable>
  </ApplicationDeliveryPreferences>
  <RequesterCredentials>
    <eBayAuthToken>-</eBayAuthToken>
  </RequesterCredentials>
</SetNotificationPreferencesRequest>

Call SetNotificationPreferences at the user level

<?xml version="1.0" encoding="utf-8"?>
<SetNotificationPreferencesRequest xmlns="urn:ebay:apis:eBLBaseComponents">
  <ErrorLanguage>en_US</ErrorLanguage>
  <Version>1127</Version>
  <WarningLevel>High</WarningLevel>
  <UserDeliveryPreferenceArray>
    <NotificationEnable>
      <EventType>ItemClosed</EventType>
      <EventEnable>Enable</EventEnable>
    </NotificationEnable>
  </UserDeliveryPreferenceArray>
  <RequesterCredentials>

    <eBayAuthToken>-</eBayAuthToken>  (Application will notify user for this token at the ApplicationURL)
  </RequesterCredentials>
</SetNotificationPreferencesRequest>

 

Notification payload upon EndItem API call (or natural end of item)

<?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="http://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">CMe3tRQqdMrpCESPr15UA==</ebl:NotificationSignature>
  </ebl:RequesterCredentials>
 </soapenv:Header>
 <soapenv:Body>
  <GetItemResponse xmlns="urn:ebay:apis:eBLBaseComponents">
   <Timestamp>2022-08-08T20:27:56.789Z</Timestamp>
   <Ack>Success</Ack>
   <CorrelationID>292717320</CorrelationID>
   <Version>1193</Version>
   <Build>E1193_CORE_API_19146280_R1</Build
   <NotificationEventName>ItemClosed</NotificationEventName>

   <RecipientUserID>ebay_userid</RecipientUserID>     (eBay UserID of token holder for above SetNotificationPreference call at the user level)
   <Item>
    <AutoPay>false</AutoPay>

    ...

   (further data from GetItem call on the item that ended)

REF: ItemClosed Notification

 

How well did this answer your question?
Answers others found helpful

Got thoughts? Click the feedback button – your insights help us improve!