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.

Documents

Merchant acquiriers — schema guidance

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

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.

Updates to this page

Published 17 December 2024
Last updated 15 May 2025
  1. 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. First published.

Sign up for emails or print this page