Skip to main content
Published: December 20 2005, 4:39:00 PMUpdated: November 28 2020, 1:49:20 PM

How can I test Chinese Auction Platform Notifications?

How do I test Chinese Auction Notifications?


The first thing to understand with Chinese Auction items is to know which notifications are generated for these items. The list below describes the transactional notifications delivered in the lifecycle of a Chinese Auction item.

1. Item created -> _ItemListed_
2. Item ends or is purchased via BIN -> _EndOfAuction_
3. Buyer requests total from the seller -> _CheckoutBuyerRequestsTotal_
4. Buyer completes checkout -> _AuctionCheckoutComplete_


In order to test Chinese Auction notifications, you need to first set up a sandbox seller, a sandbox buyer, and one or more test Chinese auction items. Then you need to subscribe your application and seller to the appropriate notifications. This article walks through the steps needed to test this scenario. In this article we will include information on Chinese auction items and those with a Buy It Now option.


1. Create 2 Sandbox test users. For the purposes of this article, we will call them testseller1, testbuyer1
http://developer.ebay.com/DevZone/sandboxuser.asp

2. Create tokens for both users via the Token Generation Tool. http://developer.ebay.com/tokentool/


3. Set up Application Level notification preferences via the SetNotificationPreferences call. You may use any user’s token for setting Application Level preferences.

<SetNotificationPreferencesRequest xmlns="urn:ebay:apis:eBLBaseComponents">
<Version>439</Version>
<ApplicationDeliveryPreferences>
<ApplicationURL>http://www.mycompany.com/notifyurl.cgi</ApplicationURL>
<ApplicationEnable>Enable</ApplicationEnable>
</ApplicationDeliveryPreferences>
</SetNotificationPreferencesRequest>

Note: If you have not yet set up your notifications listener URL or are not sure if you are actually receiving notifications, you can set your <ApplicationURL> to use SMTP and send you the notification via email. To do this, set the < ApplicationURL> property to mailto://youremailaddress@yourdomain.com.

4. Set up User Level notification preferences to enable the three notifications listed below for your seller via the SetNotificationPreferences call. Make the call once using testseller1’s token. An example is shown below:

<SetNotificationPreferencesRequest xmlns="urn:ebay:apis:eBLBaseComponents">
<Version>439</Version>
<UserDeliveryPreferenceArray>
<NotificationEnable>
<EventType>ItemListed</EventType>
<EventEnable>Enable</EventEnable>
</NotificationEnable>
<NotificationEnable>
<EventType>EndOfAuction</EventType>
<EventEnable>Enable</EventEnable>
</NotificationEnable>
<NotificationEnable>
<EventType>CheckoutBuyerRequestsTotal</EventType>
<EventEnable>Enable</EventEnable>
</NotificationEnable
<NotificationEnable>
<EventType>AuctionCheckoutComplete</EventType>
<EventEnable>Enable</EventEnable>
</NotificationEnable
</UserDeliveryPreferenceArray>
</SetNotificationPreferencesRequest>

5. Turn checkout ON for your items
a. Go to the sandbox at http://my.sandbox.ebay.com/ws/eBayISAPI.dll?MyEbay
b. Login using your seller account
c. Click on MyAccount->Preferences
d. Under Selling Preferences, click on “Show” for Payment from buyers
e. Use Checkout should be marked as Yes. If it is not, set it to Yes.

Testing with BIN Option
-------------------------------

6. List a Chinese Auction Item using testseller1’s token
<?xml version="1.0" encoding="utf-8"?>
<AddItemRequest xmlns="urn:ebay:apis:eBLBaseComponents">
<DetailLevel>ItemReturnDescription</DetailLevel>
<Version>437</Version>
<Item>
<BuyItNowPrice>10.0</BuyItNowPrice>
<Country>US</Country>
<Currency>USD</Currency>
<Description>Test Chinese Auction</Description>
<ListingDuration>Days_1</ListingDuration>
<Location>San Jose, CA</Location>
<PaymentMethods>PaymentSeeDescription</PaymentMethods>
<PrimaryCategory>
<CategoryID>357</CategoryID>
</PrimaryCategory>
<Quantity>1</Quantity>
<RegionID>0</RegionID>
<StartPrice>1.0</StartPrice>
<ShippingTermsInDescription>True</ShippingTermsInDescription>
<Title>Test Chinese Auction</Title>
</Item>
<RequesterCredentials>
<eBayAuthToken>Token</eBayAuthToken>
</RequesterCredentials>
</AddItemRequest>

7. * You should now receive an _ItemListed_ notification.
8. Log into the sandbox as testbuyer1 and purchase the item just created via the BuyItNow option. Do not yet proceed to checkout.
9. At this point your seller should receive an _EndOfAuction _ notification for the item.

10. Now log into sandbox as testbuyer1 and go to MyeBay. Find the item you have just purchased, and choose ‘RequestTotal’ from the dropdown menu next to your purchased item.
11. * You should now receive a _CheckoutBuyerRequestsTotal_ notification. (Note: This action is optional for buyers. You will only receive this notification when a buyer actually requests a total.)

12. Log into the sandbox as testbuyer1 and view the item you purchased.

13. Click on the PayNow button and complete the checkout flow. You can use a payment option such as Other or Personal Check to complete the transaction.

14. * You should now receive a _AuctionCheckoutComplete_ notification

Testing with Bid Option
-------------------------------

15. Now create a second item with the same AddItem template above.

16. * You should now receive an _ItemListed_ notification.
17. Log into the sandbox as testbuyer1 and purchase the item just created and bid on it ( do not Buy It Now ) . Do not yet proceed to checkout.
18. Call EndItem as shown below, by replacing your item id with the item id listed. (Note: This is simulating the ending of the item. You can also choose to wait until the item ends naturally. )
<?xml version="1.0" encoding="utf-8"?>
<EndItemRequest xmlns="urn:ebay:apis:eBLBaseComponents">
<Version>437</Version>
<ItemID>4504228412</ItemID>
<EndingReason>LostOrBroken</EndingReason>
<RequesterCredentials>
<eBayAuthToken>Token</eBayAuthToken>
</RequesterCredentials>
</EndItemRequest>

19. At this point your seller should receive an _EndOfAuction _ notification for the item.

20. Now log into sandbox as testbuyer1 and go to MyeBay. Find the item you have just purchased, and choose ‘RequestTotal’ from the dropdown menu next to your purchased item.
21. * You should now receive a _CheckoutBuyerRequestsTotal_ notification. (Note: This action is optional for buyers. You will only receive this notification when a buyer actually requests a total.)

22. Log into the sandbox as testbuyer1 and view the item you purchased.

23. Click on the PayNow button and complete the checkout flow. You can use a payment option such as Other or Personal Check to complete the transaction.

24. * You should now receive a _AuctionCheckoutComplete_ notification




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