What is the latest version of pain.017?

The latest version in the ISO 20022 e-Repository release of 24 April 2025 is pain.017.001.04.

What is the root element of pain.017?

The XML document is Document with the namespace urn:iso:std:iso:20022:tech:xsd:pain.017.001.04, and its message element is MndtCpyReq (MandateCopyRequest).

Is there an MT equivalent of pain.017?

No Swift MT message is listed as its direct equivalent on this site. Many ISO 20022 messages have no MT counterpart.

pain: Payments Initiation

pain.017 Mandate Copy Request

Written and maintained by ZagTrader. Last reviewed 21 October 2026. How this page is sourced and checked

pain.017 is the ISO 20022 MandateCopyRequest message in the Payments Initiation business area (pain). The latest version is pain.017.001.04, and 4 versions are in the repository.

Message: MandateCopyRequest
Latest version: pain.017.001.04
Submitting organisation: Swift & SABS
MT equivalent: None listed

In use: published in the current ISO 20022 catalogue.

What pain.017 is for

The MandateCopyRequest message is sent by the initiator of the request to his agent. The initiator can either be the debtor or the creditor.
The MandateCopyRequest message is forwarded by the agent of the initiator to the agent of the counterparty.
A MandateCopyRequest message is used to request a copy of an existing mandate. If accepted, the mandate copy can be sent using the MandateAcceptanceReport message.
The MandateCopyRequest message can contain one or more copy requests.
The messages can be exchanged between creditor and creditor agent or debtor and debtor agent and between creditor agent and debtor agent.
The message can also be used by an initiating party that has authority to send the message on behalf of the creditor or debtor.
The MandateCopyRequest message can be used in domestic and cross-border scenarios.

Definition from the ISO 20022 e-Repository, release of 24 April 2025.

pain.017 versions

Every version published in the e-Repository, newest first. A message keeps its business purpose across versions; each new version is a separate schema with its own namespace.

Version	Registration status	Published in
pain.017.001.04latest	Registered	Latest version set
pain.017.001.03	Registered	Previous version set
pain.017.001.02	Registered	Archive
pain.017.001.01	Registered	Archive

pain.017 message structure

The building blocks of pain.017.001.04 to three levels, with multiplicity ([0..1] optional, [1..1] mandatory, * any number) and the data type or component. Element names and definitions are from the ISO 20022 repository; usage guidelines such as CBPR+ or a market infrastructure's rules can restrict them further.

Document [1..1]
- MndtCpyReq MandateCopyRequest [1..1]
  - GrpHdr Group Header [1..1]GroupHeader110
    Set of characteristics to identify the message and parties playing a role in the mandate copy request, but which are not part of the mandate.
    - MsgId Message Identification [1..1]Max35Text
      Point to point reference, as assigned by the instructing party, and sent to the instructed party, to unambiguously identify the message.
    - CreDtTm Creation Date Time [1..1]ISODateTime
      Date and time at which the message was created.
    - Authstn Authorisation [0..2]Authorisation1Choice (choice)
      User identification or any user key to be used to check the authority of the initiating party.
      - Cd Code [1..1]Authorisation1Code
      - Prtry Proprietary [1..1]Max128Text
    - InitgPty Initiating Party [0..1]PartyIdentification272
      Party that initiates the mandate message.
      - Nm Name [0..1]Max140Text
      - PstlAdr Postal Address [0..1]PostalAddress27
      - Id Identification [0..1]Party52Choice (choice)
      - CtryOfRes Country Of Residence [0..1]CountryCode
      - CtctDtls Contact Details [0..1]Contact13
    - InstgAgt Instructing Agent [0..1]BranchAndFinancialInstitutionIdentification8
      Agent that instructs the next party in the chain to carry out an instruction.
      - FinInstnId Financial Institution Identification [1..1]FinancialInstitutionIdentification23
      - BrnchId Branch Identification [0..1]BranchData5
    - InstdAgt Instructed Agent [0..1]BranchAndFinancialInstitutionIdentification8
      Agent that is instructed by the previous party in the chain to carry out an instruction.
      - FinInstnId Financial Institution Identification [1..1]FinancialInstitutionIdentification23
      - BrnchId Branch Identification [0..1]BranchData5
  - UndrlygCpyReqDtls Underlying Copy Request Details [1..*]MandateCopy4
    Set of information used to identify the mandate for which a copy is requested.
    - OrgnlMsgInf Original Message Information [0..1]OriginalMessageInformation1
      Provides information on the original message.
      - MsgId Message Identification [1..1]Max35Text
      - MsgNmId Message Name Identification [1..1]Max35Text
      - CreDtTm Creation Date Time [0..1]ISODateTime
    - OrgnlMndt Original Mandate [1..1]OriginalMandate10Choice (choice)
      Provides the original mandate data.
      - OrgnlMndtId Original Mandate Identification [1..1]Max35Text
      - OrgnlMndt Original Mandate [1..1]Mandate20
    - MndtSts Mandate Status [0..1]MandateStatus1Choice (choice)
      Indicates the status of the mandate.
      - Cd Code [1..1]ExternalMandateStatus1Code
      - Prtry Proprietary [1..1]Max35Text
    - SplmtryData Supplementary Data [0..*]SupplementaryData1
      Additional information that cannot be captured in the structured elements and/or any other specific block.
      - PlcAndNm Place And Name [0..1]Max350Text
      - Envlp Envelope [1..1]SupplementaryDataEnvelope1
  - SplmtryData Supplementary Data [0..*]SupplementaryData1
    Additional information that cannot be captured in the structured elements and/or any other specific block.
    - PlcAndNm Place And Name [0..1]Max350Text
      Unambiguous reference to the location where the supplementary data must be inserted in the message instance.
    - Envlp Envelope [1..1]SupplementaryDataEnvelope1
      Technical element wrapping the supplementary data.

Have a pain.017 message? Paste it into the parser to see every element with its name and definition, and format checks on BICs, IBANs, dates and amounts.

External code sets used in pain.017

These elements take their values from ISO 20022 external code sets, which are published separately and updated every quarter without a new message version.

pain.017 questions

What is the latest version of pain.017?: The latest version in the ISO 20022 e-Repository release of 24 April 2025 is pain.017.001.04.
What is the root element of pain.017?: The XML document is Document with the namespace urn:iso:std:iso:20022:tech:xsd:pain.017.001.04, and its message element is MndtCpyReq (MandateCopyRequest).
Is there an MT equivalent of pain.017?: No Swift MT message is listed as its direct equivalent on this site. Many ISO 20022 messages have no MT counterpart.

All ISO 20022 messages · ISO 20022 code sets · MT messages

The ISO 20022 message definitions, element names and definitions on this page are reproduced from material published at iso20022.org under the ISO 20022 Intellectual Property Rights policy. This is not the official source: the up-to-date ISO 20022 standards and repository material are published only at iso20022.org. Explanations in our own words are by ZagTrader. ZagTrader is not affiliated with or endorsed by ISO or Swift.