Find the answer to your question
Advanced Search
Platform Notifications are delivered as SOAP messages. Each messages body is equivalent to the response from a corresponding API call listed below.
|
Notification Event Name |
Payload Type |
|
ItemListed |
GetItemResponse |
|
ItemClosed |
GetItemResponse |
|
ItemUnsold |
GetItemResponse |
|
BidPlaced |
GetItemResponse |
|
BidReceived |
GetItemResponse |
|
OutBid |
GetItemResponse |
|
SecondChanceOffer |
GetItemResponse |
|
ItemRevised |
GetItemResponse |
|
WatchedItemEndingSoon |
GetItemResponse |
|
ItemAddedToBidGroup |
GetItemResponse |
|
ItemAddedToWatchList |
GetItemResponse |
|
ItemRemovedFromBidGroup |
GetItemResponse |
|
ItemRemovedFromWatchList |
GetItemResponse |
|
ItemRevisedAddCharity |
GetItemResponse |
|
ItemSold |
GetItemResponse |
|
ItemWon |
GetItemResponse |
|
EndOfAuction |
GetItemTransactionsResponse |
|
AuctionCheckoutComplete |
GetItemTransactionsResponse |
|
FixedPriceTransaction |
GetItemTransactionsResponse |
|
CheckoutBuyerRequestsTotal |
GetItemTransactionsResponse |
|
ItemMarkedPaid |
GetItemTransactionsResponse |
|
ItemMarkedShipped |
GetItemTransactionsResponse |
|
UPIBuyerResponseDispute |
GetDisputeResponse |
|
SellerClosedDispute |
GetDisputeResponse |
|
SellerOpenedDispute |
GetDisputeResponse |
|
SellerRespondedToDispute |
GetDisputeResponse |
|
BuyerResponseDispute |
GetDisputeResponse |
|
MyMessagesAlert |
GetMyMessagesResponse |
|
MyMessageseBayMessageHeader |
GetMyMessagesResponse |
|
MyMessagesAlertHeader |
GetMyMessagesResponse |
|
MyMessageseBayMessage |
GetMyMessagesResponse |
|
MyMessagesM2MMessage |
GetMyMessagesResponse |
|
MyMessagesM2MMessageHeader |
GetMyMessagesResponse |
|
AskSellerQuestion |
GetMemberMessagesResponse |
|
Feedback |
GetFeedbackResponse |
|
FeedbackReceived |
GetFeedbackResponse |
|
FeedbackLeft |
GetFeedbackResponse |
|
FeedbackStarChanged |
GetFeedbackResponse |
|
BestOffer |
GetFeedbackResponse |
|
BestOfferDeclined |
GetFeedbackResponse |
|
BestOfferPlaced |
GetFeedbackResponse |
|
CounterOfferReceived |
GetFeedbackResponse |
|
TokenRevocation |
GetTokenStatusResponse |
The name of the event that the notification is being sent is appended in the end of the SOAPAction HTTP request header field as SOAPACTION: "HTTPS://developer.ebay.com/notification/EndOfAuction", which can be used to indicate the coming SOAP messages and deserialize it to the corrsponding to the Trading API response datatype showing in the above table for processing.
Notifications Common Pitfalls
-
Firewall blocks delivery
Use GetNotificationsUsage to query eBay's logs for delivery info. Timeouts may indicate your firewall is blocking delivery
Poll with the underlying API calls as a complement to notifications -
Subscription not set up, or set up incorrectly
Use the GetNotificationPreferences call to check your app and user level subscription info -
Your Platform Notifications Listener processes before returning a 200 OK response
Servers should return 200 OK right away. This signals to eBay that you have received the request. Otherwise, an eBay side timeout may occur by the time you finish processing