What is the latest version of pain.018?

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

What is the root element of pain.018?

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

Is there an MT equivalent of pain.018?

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.018 Mandate Suspension Request

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

pain.018 is the ISO 20022 MandateSuspensionRequest message in the Payments Initiation business area (pain). The latest version is pain.018.001.04, and 4 versions are in the repository.

Message: MandateSuspensionRequest
Latest version: pain.018.001.04
Submitting organisation: Swift & SABS
MT equivalent: None listed

In use: published in the current ISO 20022 catalogue.

What pain.018 is for

The MandateSuspensionRequest message is sent by the initiator of the request to its agent. The initiator can either be the debtor, debtor agent, creditor or creditor agent.
A MandateSuspensionRequest message is used to request the suspension of an existing mandate until the suspension is lifted.
The MandateSuspensionRequest message can contain one or more suspension requests.
The messages can be exchanged between creditor and creditor agent or debtor and debtor agent and between creditor agent and debtor agent.
The MandateSuspensionRequest message can be used in domestic and cross-border scenarios.

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

pain.018 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.018.001.04latest	Registered	Latest version set
pain.018.001.03	Registered	Previous version set
pain.018.001.02	Registered	Archive
pain.018.001.01	Registered	Archive

pain.018 message structure

The building blocks of pain.018.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]
- MndtSspnsnReq MandateSuspensionRequest [1..1]
  - GrpHdr Group Header [1..1]GroupHeader110
    Set of characteristics to identify the message and parties playing a role in the mandate suspension 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
  - UndrlygSspnsnDtls Underlying Suspension Details [1..*]MandateSuspension4
    Set of elements used to provide information on the suspension request of the mandate.
    - SspnsnReqId Suspension Request Identification [1..1]Max35Text
      Unique identification, as assigned by the initiating party, to unambiguously identify the suspension request.
    - 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
    - SspnsnRsn Suspension Reason [1..1]MandateSuspensionReason3
      Provides detailed information on the suspension reason.
      - Orgtr Originator [0..1]PartyIdentification272
      - Rsn Reason [1..1]MandateSuspensionReason1Choice (choice)
      - AddtlInf Additional Information [0..*]Max105Text
    - 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
    - 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.018 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.018

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.018 questions

What is the latest version of pain.018?: The latest version in the ISO 20022 e-Repository release of 24 April 2025 is pain.018.001.04.
What is the root element of pain.018?: The XML document is Document with the namespace urn:iso:std:iso:20022:tech:xsd:pain.018.001.04, and its message element is MndtSspnsnReq (MandateSuspensionRequest).
Is there an MT equivalent of pain.018?: 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.