The eBay Merchant Integration Platform (MIP) is a powerful, easy-to-use application that eBay sellers can use to manage product listings and orders. See Basic description for additional information.

To use MIP, you should already be familiar with selling on eBay.

MIP updates

Periodically, new fields are added to MIP feeds. In most cases, new fields in CSV files are appended to the end of changed feed file, and new fields in XML files are added to the end of the request/response payload or to the end of an existing container. Changes are communicated through the What's new section.

Important! All MIP users should monitor this guide to keep current on new and modified fields. For users who are programmatically using MIP, it is recommended that their integrations be coded to accommodate all updates. As a best practice, always reference the fields or columns by their names, and not by their absolute or relative position in a feed.

What’s new

The following updates have been made to the Merchant Integration Platform.

Release Date

Feature Description

February 2024

Added support for Economic Operator fields. See Distribution Feed Definitions, Combined Feed Definitions, and Sample feed and response files.

Added new security algorithms to support enhanced security measures. See Feed Schema for more information.

January 2024

The following CBC mode ciphers and MD5 MACs have been deprecated:

  • chacha20-poly1305@openssh.com
  • hmac-sha2-512-etm@openssh.com
  • hmac-sha2-256-etm@openssh.com

Refer to the Deprecated Ciphers, MACs, and Key Exchange table for a complete list of deprecated ciphers, MACs, and key exchanges.

For the list of preferred ciphers and MACs for use with the SFTP server, listed in order of preference, refer to Preferred Ciphers and MACs.

October 2023

New linkedLineItem field added to Order Report. This field will provide data on a line item that is linked to the corresponding order, but not actually a part of the order. This can be used to provide details about a component (purchased from one seller) needed for its installation (purchased from a different seller). Details can identify the linked seller and also include delivery times, item information, and order information. See Pending orders response definitions.

August 2023

This version of the MIP guide supersedes the previous version. Bookmark this page for future reference: https://developer.ebay.com/api-docs/user-guides/static/mip-user-guide-landing.html

July 2023

Condition descriptors for specific trading card categories are now supported on all eBay marketplaces. See Product Feed Definitions, Combined Feed Definitions, and Sample feed and response files.

June 2023

Added support for condition descriptors to specific trading card categories. Currently available only in the United Kingdom (GB), with rollout to all other marketplaces early July 2023. See Product Feed Definitions, Combined Feed Definitions, and Sample feed and response files.

May 2023

Added support for Energy Efficiency Labels, Hazmat information, and Regional Seller Disclosures for the German (DE) marketplace. See Distribution feed definitions, Combined Feed Definitions, and Sample feed and response files.

January 2022

Added support for Extended Producer Responsibility and compliance policies through listing creation and orders. See Distribution feed definitions, Combined Feed Definitions, and Sample feed and response files. Use Extended Producer Responsibility to provide IDs for the producer or importer related to the new item, and compliance policies to specify custom policy IDs. A custom policy ID refers to the relevant policy created for compliance and other purposes.

August 2021

Due to security concerns with Cipher Block Chaining (CBC) and MD5 encryption when using the SFTP server, a number of CBC mode ciphers and MD5 MACs have been deprecated. See the Deprecated Ciphers, MACs, and Key Exchange table in Uploading the sample feed for details.

July 2021

Added a new eBayReferenceName field for describing VAT (Value Added Tax) for sales involving regions where VAT is applicable (see Distribution feed definitions and Sample feed and response files).

The field contains an eBay Tax Number and also possesses a Name attribute, which delineates the region for which the VAT is applied.

May 2021

Added support for secondary categories and private listings to the distribution feed type (see Distribution feed definitions and Sample feed and response files).

  • Use secondary categories to list the item under two categories. A fee may be charged when adding a secondary category to a listing.
  • With private listings, the user IDs of buyers/bidders are only shown to the seller of the listing, and not to any other eBay users

Other miscellaneous document updates.