Guidance

Merchant acquirer reports — XML schema and guidance

Find the schema and supporting documents for software developers, or agents, acting on behalf of merchant acquirers who send returns to HMRC.

• From: HM Revenue & Customs
• Published: 17 December 2024
• Last updated: 15 May 2025 — See all updates

Documents

Merchant acquiriers — schema guidance

ODT, 49.8 KB

This file is in an OpenDocument format

This file may not be suitable for users of assistive technology.

Request an accessible format.

If you use assistive technology (such as a screen reader) and need a version of this document in a more accessible format, please email different.format@hmrc.gov.uk. Please tell us what format you need. It will help us if you say what assistive technology you use.

Merchant acquirers — XML schema for suppliers

ZIP, 2.59 KB

This file may not be suitable for users of assistive technology.

Request an accessible format.

If you use assistive technology (such as a screen reader) and need a version of this document in a more accessible format, please email different.format@hmrc.gov.uk. Please tell us what format you need. It will help us if you say what assistive technology you use.

Details

This page contains:

• technical specification guidance
• XML schema
• supporting documents

Use the information on this page if you’re a merchant acquirer and need to construct and populate your returns in XML format for submission to HMRC.

Published 17 December 2024

Last updated 15 May 2025 + show all updates

1. 15 May 2025

   Merchant acquirer - schema guidance section 'maximum file size' has been updated. Information about the section 1 elements “Submission Reference” to the “Total Value of Chargebacks” are the control totals for the whole submission, they must be present and the same in every batch file.

2. 17 December 2024

   First published.