eBay Trading APIVersion 1225

SellerPaymentPreferencesType

Type defining the SellerPaymentPreferences container, which consists of the seller's payment preferences. Payment preferences specified in a SetUserPreferences call override the settings in My eBay payment preferences.

Note: Sellers in the eBay managed payments program cannot control some of the settings under the SellerPaymentPreferences container, and although some of these fields can still be set in SetUserPreferences and returned in GetUserPreferences, the settings will not have any affect on any current or future listings for the seller. eBay managed payments is currently available to a select set of sellers. For the current list of eBay marketplaces in which eBay managed payments has rolled out, see the eBay Managed Payments landing page.

Types that use SellerPaymentPreferencesType:

Calls that use SellerPaymentPreferencesType:

Fields



AlwaysUseThisPaymentAddress ( boolean ) [0..1]
Sellers include this field and set it to true if they want buyers to mail payment to the payment address specified in the SellerPaymentPreferences.SellerPaymentAddress field. A payment address only comes into play if the item's category allows offline payments, and the seller has allowed the buyer to mail a payment. This payment address will only be displayed to winning bidders and buyers.

Note: Although it can still be set as a payment preference, this field does not apply to sellers onboarded for managed payments since having a PayPal account is not a requirement for these sellers.
See the Field Index to learn which calls use AlwaysUseThisPaymentAddress.

DefaultPayPalEmailAddress ( string ) [0..1]
Specifies the default email address the seller uses for receiving PayPal payments.

Note: Although it can still be set as a payment preference, this field does not apply to sellers onboarded for managed payments since having a PayPal account is not a requirement for these sellers.
See the Field Index to learn which calls use DefaultPayPalEmailAddress.

DisplayPayNowButton ( DisplayPayNowButtonCodeType ) [0..1]
If set, this field determines whether a Pay Now button is displayed for all of the user's listings. The user has the option of using a PayPal only version of the Pay Now button or a Pay Now button for all payment methods.

Note: Sellers in the eBay managed payments program cannot control the display of the "Buy It Now" button in listings, and although the DisplayPayNowButton value can still be set in SetUserPreferences and returned in GetUserPreferences, the setting will not have any affect on any current or future listings for the seller. eBay managed payments is currently available to a select set of sellers. For the current list of eBay marketplaces in which eBay managed payments has rolled out, see the eBay Managed Payments landing page.
See the Field Index to learn which calls use DisplayPayNowButton.

FedExRateOption ( FedExRateOptionCodeType ) [0..1]
This enumeration value indicates the type of FedEx shipping rates that are available to the seller.
See the Field Index to learn which calls use FedExRateOption.

PayPalAlwaysOn ( boolean ) [0..1]
Indicates whether PayPal is always accepted for the seller's listings.

Note: Sellers in the eBay managed payments program cannot control the "PayPal Always On" setting in listings, and although the PayPalAlwaysOn boolean value can still be set in SetUserPreferences and returned in GetUserPreferences, the setting will not have any affect on any current or future listings for the seller. eBay managed payments is currently available to a select set of sellers. For the current list of eBay marketplaces in which eBay managed payments has rolled out, see the eBay Managed Payments landing page.
See the Field Index to learn which calls use PayPalAlwaysOn.

PayPalPreferred ( boolean ) [0..1]
Specifies whether a seller wants to let buyers know that PayPal payments are preferred.

Note: Sellers in the eBay managed payments program cannot control the display of the "PayPal Preferred" setting in listings, and although the PayPalPreferred boolean value can still be set in SetUserPreferences and returned in GetUserPreferences, the setting will not have any affect on any current or future listings for the seller. eBay managed payments is currently available to a select set of sellers. For the current list of eBay marketplaces in which eBay managed payments has rolled out, see the eBay Managed Payments landing page.
See the Field Index to learn which calls use PayPalPreferred.

SellerPaymentAddress ( AddressType ) [0..1]
Specifies the address the seller uses to receive mailed payments from buyers.
See the Field Index to learn which calls use SellerPaymentAddress.

UPSRateOption ( UPSRateOptionCodeType ) [0..1]
This enumeration value indicates the type of UPS shipping rates that are available to the seller.
See the Field Index to learn which calls use UPSRateOption.

USPSRateOption ( USPSRateOptionCodeType ) [0..1]
This enumeration value indicates the type of US Postal Service shipping rates that are available to the seller.
See the Field Index to learn which calls use USPSRateOption.