eBay Trading API
Call Reference Version 585

The email address where eBay sends all application markup and markdown event notifications. When setting the email address, input must be in the format mailto://youremailaddress@yoursite.com (with the mailto:// prefix). The application has to subscribe to recieve these events using the AlertEnable field.

A token indicating whether markup and markdown alerts are enabled or disabled.

Indicates whether notifications and alerts are enabled or disabled. If you disable notifications, the application does not receive them, but notification preferences are not erased.

The URL where eBay delivers all notifications sent to the application. For delivery to a server, the URL begins with http:// or https:// and must be well formed. Use a URL that is functional at the time of the call. For delivery to an email address, the URL begins with mailto: and specifies a valid email address.

Defines settings for a notification URL (including the URL name in DeliveryURLName). You define settings for a notification URL (including the URL name in DeliveryURLName) in the DeliveryURLDetails container. You associate a user token with a notification URL by using the token in a SetNotificationPreferences request that specifies the URL name in SetNotificationPreferencesRequest.DeliveryURLName. If you associate a single user token to multiple URL names, each URL name overwrites the previous name associated with the token. You can specify up to 10 notification URLs for an application. Note that Notifications will not be sent to any URL(s) if ApplicationDeliveryPreferencesType.ApplicationEnable is set to Disable.

Do not test Client Alerts in production if you are currently using Platform Notifications. The means of receipt of notification. In most cases, it is Platform (typical API calls and web interaction), so this is the default, if not specified. For wireless applications, use SMS.

If this field is specified, the value must be eBLSchemaSOAP.

If you are using SetNotificationPreferences, you can use the PayloadVersion field to specify the API version for all notifications for the calling application. If you are using GetNotificationPreferences, this field contains the API version for all notifications for the calling application. If you do not specify PayloadVersion in SetNotificationPreferences, the behavior of notifications is the same as it was before the PayloadVersion field was added to the schema. Before the PayloadVersion field was added to the schema, the API version for notifications was based on the API version specified as part of your SetNotificationPreferences call. Now, you can use PayloadVersion to override the API version specified as part of your SetNotificationPreferences call.