The API release history
The following table lists the releases for the Account API v2:
| Version | Release Date | Summary of Release |
|---|---|---|
| Version 2.2.0 | 2026-02-26 | Added eight methods through the combined_shipping_rules resource and two methods through the user_preferences resource. |
| Version 2.1.0 | 2023-08-28 | Added eight new methods, getPayoutSettings and updatePayoutPercentage, to support split payout functionality for sellers in Mainland China. |
| Version 2.0.0 | 2022-03-03 | Initial release of Version 2. |
Version 2.2.0
This release adds the ability for sellers to retrieve and manage their combined shipping rules that that determine shipping discounts for the buyer, and also to set/retrieve user account preferences such as combined invoices, same-day shipping, and shipment tracking.
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 |
|---|---|
|
Create calculated shipping rules that determine combined shipping costs based on item attributes (such as weight, dimensions), for the seller's account. |
|
|
Create flat-rate rules that apply standard that apply standard combined shipping costs for a seller's listings. |
|
|
Define promotional shipping rules, such as discounts or free-shipping thresholds. |
|
|
Retrieve all combined shipping rule configurations defined for the seller. |
|
|
Update a previously defined calculated shipping rules. |
|
|
Configure or modify combined payment settings that determine how unpaid orders can be merged. |
|
|
Update existing flat-rate shipping rules. |
|
|
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 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 |
|---|---|
|
Retrieve the seller's preferences. |
|
|
Set or update the seller's preferences. |
Version 2.1.0
This release adds new methods to support split-payout functionality for eBay sellers based in mainland China.
New Methods
Two new methods have been added that allow sellers in Mainland China to configure split payouts between two separate payment instruments, such as between 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.
Version 2.0.0
The initial release of the Account API v2. Version 2.0.0, was released on March 3, 2022.
For a list of the methods, see the Account API v2 Reference.