HomeDocumentationCode SamplesAPI ReferenceAnnouncementsModelsRelease NotesFAQGitHubVideos
Developer HubAPI StatusSupport
Announcements
Developer HubAPI StatusSupport
Start typing to search…
Back to All

Deprecation of two payment settlement report types

March 17th, 2025 by Lisa

The following settlement reports are announcing deprecation and will be unavailable for sellers as of March 25, 2026:

These reports are replaced with the Flat File V2 Settlement Report (GET_V2_SETTLEMENT_REPORT_DATA_FLAT_FILE_V2). There is no XML report replacement. The Flat File V2 Settlement Report is currently available and offers the following benefits:

  • Presents the same information in fewer columns
  • Ensures that you don’t have empty cells in the amount-type, amount-description, or amount columns
  • Allows for more details in the amount-type and amount-description columns for the type of charge or fee you have incurred, and indicates whether different fees are related to a common type
  • Ensures amount values always populate in a single amount column so you don't have to parse the rows to find the number that you need, even if new fees or transaction types are introduced in the future
  • Categorizes amounts in the amount-type and amount-description columns in the same row
  • Provides quantities for all rows (in line with amounts) and posted dates are provided in two, easily-readable formats, posted-date (MM/DD/YY) and posted-date-time (YYYY-MM-DD HH:MM:SS UTC)
  • Displays amounts in local currency format (for example, 95,00 for EU instead of 95.00)

Which marketplaces are affected?

This change applies to all marketplaces.

What action is required?

If you have an application that is affected by this change, migrate to the new version and ensure that your applications no longer use the deprecated settlement report after March 25, 2026.

The following table shows which fields replace the corresponding settlement report flat file fields:

Flat FileFlat File V2
price type name, fee type name
Example: item-related-fee-type		amount-type
price type value, fee type value
Example: Commission		amount-description
price amount, fee amount
Example: item-related-fee-amount		amount
transaction-typetransaction-type or amount-description
price type, fee type
Example: other-fee-reason-description		amount-description (disjointed amounts may be consolidated)

Need more information?

For more information, refer to the Flat File V2 settlement report.

If you need additional assistance, contact Developer Support.