| Release Version | Release Date | Description of Release |
|---|---|---|
| 2.2.0 | 2026-02-26 | Added eight methods through the combined_shipping_rules resource and two methods through the user_preferences resource. |
| 2.1.0 | 2023-08-28 | Added eight new methods, getPayoutSettings and updatePayoutPercentage, to support split payout functionality for sellers in Mainland China. |
| 2.0.0 | 2022-03-03 | Initial release of Version 2. |
2.2.0
The following changes have been made in this release.
Version 2.2.0
This release adds support for sellers to retrieve and manage combined shipping rules that determine buyer shipping discounts. It also adds support for retrieving and setting user account preferences, including combined invoices, same-day shipping, and shipment tracking settings.
Create and manage a seller's combined shipping rules
A new resource, combined_shipping_rules, adds eight methods that let sellers configure and maintain their shipping rules for an eBay marketplace.
| Method Name | Summary |
|---|---|
| createCalculatedShippingRules | Create calculated shipping rules that determine combined shipping costs based on item attributes, such as weight and dimensions, for the seller's account. |
| createFlatShippingRules | Create flat-rate rules that apply standard combined shipping costs for a seller's listings. |
| createPromotionalShippingRule | Define promotional shipping rules, such as discounts or free-shipping thresholds. |
| getCombinedShippingRules | Retrieve all combined shipping rule configurations defined for the seller. |
| updateCalculatedShippingRules | Update previously defined calculated shipping rules. |
| updateCombinedPayments | Configure or modify combined payment settings that determine how unpaid orders can be merged. |
| updateFlatShippingRules | Update existing flat-rate shipping rules. |
| updatePromotionalShippingRule | Update a promotional shipping rule to adjust discount thresholds, eligibility criteria, or duration for the seller. |
Set and retrieve a seller's user account preferences
A new resource, user_preferences, adds two methods that let sellers retrieve and update account preferences, such as combined payment preferences, same-day shipping cutoff time, and opt-in status for Business Policies and Out-of-Stock control.
| Method Name | Summary |
|---|---|
| getUserPreferences | Retrieve the seller's preferences. |
| setUserPreferences | Set or update the seller's preferences. |
2.1.0
The following changes have been made in this release.
Version 2.1.0
This release adds methods to support split-payout functionality for eBay sellers based in mainland China.
New Methods
Two new methods were added that allow sellers in Mainland China to configure split payouts between two separate payment instruments, such as a bank account and Payoneer.
getPayoutSettings: This method returns details on two payment instruments defined on the seller's account.
updatePayoutPercentage: This method allows sellers to configure the split-payout percentage for two payment instruments available for seller payouts.
2.0.0
The following changes have been made in this release.
Version 2.0.0
This is the initial release of the Account API v2. Version 2.0.0 was released on March 3, 2022.
For a list of methods, see the Account API v2 Reference.