ZagTrader

camt: Cash Management

camt.087 Request To Modify Payment

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

camt.087 is the ISO 20022 RequestToModifyPayment message in the Cash Management business area (camt). The latest version is camt.087.001.09, and 9 versions are in the repository.

Message
RequestToModifyPayment
Latest version
camt.087.001.09
Submitting organisation
Swift
MT equivalent
None listed

In use: published in the current ISO 20022 catalogue.

What camt.087 is for

The RequestToModifyPayment message is sent by a case creator/case assigner to a case assignee.

This message is used to request the modification of characteristics of an original payment instruction.

The RequestToModifyPayment message must be answered with a:

- ResolutionOfInvestigation message with a positive final outcome when the case assignee can perform the requested modification;

- ResolutionOfInvestigation message with a negative final outcome when the case assignee may perform the requested modification but fails to do so (too late, irrevocable instruction, one requested element cannot be modified);

- RejectCaseAssignment message when the case assignee is unable or not authorised to perform the requested modification;

- NotificationOfCaseAssignment message to indicate whether the case assignee will take on the case himself or reassign the case to a subsequent party in the payment processing chain.

The RequestToModifyPayment message covers one and only one original instruction at a time. If several original payment instructions need to be modified, then multiple RequestToModifyPayment messages must be sent.

The RequestToModifyPayment message can be sent to request the modification of one or several elements of the original payment instruction. If many elements need to be modified, it is recommended to cancel the original payment instruction and initiate a new one.

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

camt.087 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.

VersionRegistration statusPublished in
camt.087.001.09latestRegisteredLatest version set
camt.087.001.08RegisteredPrevious version set
camt.087.001.07RegisteredArchive
camt.087.001.06RegisteredArchive
camt.087.001.05RegisteredArchive
camt.087.001.04RegisteredArchive
camt.087.001.03RegisteredArchive
camt.087.001.02RegisteredArchive
camt.087.001.01RegisteredArchive

camt.087 message structure

The building blocks of camt.087.001.09 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]
    • ReqToModfyPmt RequestToModifyPayment [1..1]
      • Assgnmt Assignment [1..1]CaseAssignment6

        Identifies the assignment of an investigation case from an assigner to an assignee.

        • Id Identification [1..1]Max35Text

          Uniquely identifies the case assignment.

        • Assgnr Assigner [1..1]Party50Choice (choice)

          Party who assigns the case.

          • Pty Party [1..1]PartyIdentification272
          • Agt Agent [1..1]BranchAndFinancialInstitutionIdentification8
        • Assgne Assignee [1..1]Party50Choice (choice)

          Party to which the case is assigned.

          • Pty Party [1..1]PartyIdentification272
          • Agt Agent [1..1]BranchAndFinancialInstitutionIdentification8
        • CreDtTm Creation Date Time [1..1]ISODateTime

          Date and time at which the assignment was created.

      • Case Case [0..1]Case6

        Identifies the investigation case.

        • Id Identification [1..1]Max35Text

          Uniquely identifies the case.

        • Cretr Creator [1..1]Party50Choice (choice)

          Party that created the investigation case.

          • Pty Party [1..1]PartyIdentification272
          • Agt Agent [1..1]BranchAndFinancialInstitutionIdentification8
        • ReopCaseIndctn Reopen Case Indication [0..1]YesNoIndicator

          Indicates whether or not the case was previously closed and is now re-opened.

      • Undrlyg Underlying [1..1]UnderlyingTransaction8Choice (choice)

        Identifies the payment transaction to be modified.

        • Initn Initiation [1..1]UnderlyingPaymentInstruction9

          Set of elements used to reference the details of the original payment initiation.

          • OrgnlGrpInf Original Group Information [0..1]UnderlyingGroupInformation1
          • OrgnlPmtInfId Original Payment Information Identification [0..1]Max35Text
          • OrgnlInstrId Original Instruction Identification [0..1]Max35Text
          • OrgnlEndToEndId Original End To End Identification [0..1]Max35Text
          • OrgnlUETR Original UETR [0..1]UUIDv4Identifier
          • OrgnlInstdAmt Original Instructed Amount [0..1]ActiveOrHistoricCurrencyAndAmount
          • ReqdExctnDt Requested Execution Date [0..1]DateAndDateTime2Choice (choice)
          • ReqdColltnDt Requested Collection Date [0..1]ISODate
          • OrgnlTxRef Original Transaction Reference [0..1]OriginalTransactionReference42
          • OrgnlSvcLvl Original Service Level [0..1]ServiceLevel8Choice (choice)
        • IntrBk Interbank [1..1]UnderlyingPaymentTransaction8

          Set of elements used to reference the details of the original interbank payment transaction.

          • OrgnlGrpInf Original Group Information [0..1]UnderlyingGroupInformation1
          • OrgnlInstrId Original Instruction Identification [0..1]Max35Text
          • OrgnlEndToEndId Original End To End Identification [0..1]Max35Text
          • OrgnlTxId Original Transaction Identification [0..1]Max35Text
          • OrgnlUETR Original UETR [0..1]UUIDv4Identifier
          • OrgnlIntrBkSttlmAmt Original Interbank Settlement Amount [0..1]ActiveOrHistoricCurrencyAndAmount
          • OrgnlIntrBkSttlmDt Original Interbank Settlement Date [0..1]ISODate
          • OrgnlTxRef Original Transaction Reference [0..1]OriginalTransactionReference42
          • OrgnlSvcLvl Original Service Level [0..1]ServiceLevel8Choice (choice)
        • StmtNtry Statement Entry [1..1]UnderlyingStatementEntry3

          Reference details on the underlying statement cash entry.

          • OrgnlGrpInf Original Group Information [0..1]OriginalGroupInformation29
          • OrgnlStmtId Original Statement Identification [0..1]Max35Text
          • OrgnlNtryId Original Entry Identification [0..1]Max35Text
          • OrgnlUETR Original UETR [0..1]UUIDv4Identifier
      • Mod Modification [1..1]RequestedModification11

        Identifies the list of modifications requested.

        • InstrId Instruction Identification [0..1]Max35Text

          Unique identification as assigned by an instructing party for an instructed party to unambiguously identify the instruction.

        • EndToEndId End To End Identification [0..1]Max35Text

          Unique identification, as assigned by the initiating party, to unambiguously identify the transaction.

        • TxId Transaction Identification [0..1]Max35Text

          Unique identification, as assigned by the first instructing agent, to unambiguously identify the transaction that is passed on, unchanged, throughout...

        • PmtTpInf Payment Type Information [0..1]PaymentTypeInformation27

          Set of elements used to further specify the type of transaction.

          • InstrPrty Instruction Priority [0..1]Priority2Code
          • ClrChanl Clearing Channel [0..1]ClearingChannel2Code
          • SvcLvl Service Level [0..*]ServiceLevel8Choice (choice)
          • LclInstrm Local Instrument [0..1]LocalInstrument2Choice (choice)
          • SeqTp Sequence Type [0..1]SequenceType3Code
          • CtgyPurp Category Purpose [0..1]CategoryPurpose1Choice (choice)
        • ReqdExctnDt Requested Execution Date [0..1]DateAndDateTime2Choice (choice)

          Date at which the initiating party requests the clearing agent to process the payment.

          • Dt Date [1..1]ISODate
          • DtTm Date Time [1..1]ISODateTime
        • ReqdColltnDt Requested Collection Date [0..1]ISODate

          Date and time at which the creditor requests that the amount of money is to be collected from the debtor.

        • IntrBkSttlmDt Interbank Settlement Date [0..1]ISODate

          Date on which the amount of money ceases to be available to the agent that owes it and when the amount of money becomes available to the agent to...

        • SttlmTmIndctn Settlement Time Indication [0..1]SettlementDateTimeIndication1

          Provides information on the occurred settlement time(s) of the payment transaction.

          • DbtDtTm Debit Date Time [0..1]ISODateTime
          • CdtDtTm Credit Date Time [0..1]ISODateTime
        • Amt Amount [0..1]AmountType4Choice (choice)

          Amount of money to be moved between the debtor and creditor, before deduction of charges, expressed in the currency as ordered by the initiating...

          • InstdAmt Instructed Amount [1..1]ActiveOrHistoricCurrencyAndAmount
          • EqvtAmt Equivalent Amount [1..1]EquivalentAmount2
        • IntrBkSttlmAmt Interbank Settlement Amount [0..1]ActiveOrHistoricCurrencyAndAmount

          Amount of money moved between the instructing agent and the instructed agent.

        • ChrgBr Charge Bearer [0..1]ChargeBearerType1Code

          Specifies which party/parties will bear the charges associated with the processing of the payment transaction.

        • UltmtDbtr Ultimate Debtor [0..1]PartyIdentification272

          Ultimate party that owes an amount of money to the (ultimate) creditor.

          • 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
        • Dbtr Debtor [0..1]PartyIdentification272

          Party that owes an amount of money to the (ultimate) creditor.

          • 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
        • DbtrAcct Debtor Account [0..1]CashAccount40

          Unambiguous identification of the account of the debtor to which a debit entry will be made as a result of the transaction.

          • Id Identification [0..1]AccountIdentification4Choice (choice)
          • Tp Type [0..1]CashAccountType2Choice (choice)
          • Ccy Currency [0..1]ActiveOrHistoricCurrencyCode
          • Nm Name [0..1]Max70Text
          • Prxy Proxy [0..1]ProxyAccountIdentification1
        • DbtrAgtAcct Debtor Agent Account [0..1]CashAccount40

          Unambiguous identification of the account of the debtor agent at its servicing agent in the payment chain.

          • Id Identification [0..1]AccountIdentification4Choice (choice)
          • Tp Type [0..1]CashAccountType2Choice (choice)
          • Ccy Currency [0..1]ActiveOrHistoricCurrencyCode
          • Nm Name [0..1]Max70Text
          • Prxy Proxy [0..1]ProxyAccountIdentification1
        • SttlmInf Settlement Information [0..1]SettlementInstruction16

          Instruction between two clearing agents stipulating the cash transfer characteristics between the two parties.

          • InstgRmbrsmntAgt Instructing Reimbursement Agent [0..1]BranchAndFinancialInstitutionIdentification8
          • InstgRmbrsmntAgtAcct Instructing Reimbursement Agent Account [0..1]CashAccount40
          • InstdRmbrsmntAgt Instructed Reimbursement Agent [0..1]BranchAndFinancialInstitutionIdentification8
          • InstdRmbrsmntAgtAcct Instructed Reimbursement Agent Account [0..1]CashAccount40
        • CdtrAgtAcct Creditor Agent Account [0..1]CashAccount40

          Unambiguous identification of the account of the creditor agent at its servicing agent to which a credit entry will be made as a result of the...

          • Id Identification [0..1]AccountIdentification4Choice (choice)
          • Tp Type [0..1]CashAccountType2Choice (choice)
          • Ccy Currency [0..1]ActiveOrHistoricCurrencyCode
          • Nm Name [0..1]Max70Text
          • Prxy Proxy [0..1]ProxyAccountIdentification1
        • Cdtr Creditor [0..1]PartyIdentification272

          Party to which an amount of money is due.

          • 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
        • CdtrAcct Creditor Account [0..1]CashAccount40

          Unambiguous identification of the account of the creditor to which a credit entry will be posted as a result of the payment transaction.

          • Id Identification [0..1]AccountIdentification4Choice (choice)
          • Tp Type [0..1]CashAccountType2Choice (choice)
          • Ccy Currency [0..1]ActiveOrHistoricCurrencyCode
          • Nm Name [0..1]Max70Text
          • Prxy Proxy [0..1]ProxyAccountIdentification1
        • UltmtCdtr Ultimate Creditor [0..1]PartyIdentification272

          Ultimate party to which an amount of money is due.

          • 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
        • Purp Purpose [0..1]Purpose2Choice (choice)

          Underlying reason for the payment transaction.

          • Cd Code [1..1]ExternalPurpose1Code
          • Prtry Proprietary [1..1]Max35Text
        • InstrForDbtrAgt Instruction For Debtor Agent [0..1]Max140Text

          Further information related to the processing of the payment instruction, provided by the initiating party, and intended for the debtor agent.

        • InstrForNxtAgt Instruction For Next Agent [0..*]InstructionForNextAgent1

          Further information related to the processing of the payment instruction that may need to be acted upon by the next agent.

          • Cd Code [0..1]Instruction4Code
          • InstrInf Instruction Information [0..1]Max140Text
        • InstrForCdtrAgt Instruction For Creditor Agent [0..*]InstructionForCreditorAgent3

          Further information related to the processing of the payment instruction, provided by the initiating party, and intended for the creditor agent.

          • Cd Code [0..1]ExternalCreditorAgentInstruction1Code
          • InstrInf Instruction Information [0..1]Max140Text
        • RltdRmtInf Related Remittance Information [0..10]RemittanceLocation8

          Provides information related to the handling of the remittance information by any of the agents in the transaction processing chain.

          • RmtId Remittance Identification [0..1]Max35Text
          • RmtLctnDtls Remittance Location Details [0..*]RemittanceLocationData2
        • RmtInf Remittance Information [0..1]RemittanceInformation22

          Structured information that enables the matching, that is reconciliation, of a payment with the items that the payment is intended to settle, such as...

          • Ustrd Unstructured [0..*]Max140Text
          • Strd Structured [0..*]StructuredRemittanceInformation18
      • InstrForAssgne Instruction For Assignee [0..1]InstructionForAssignee1

        Further information related to the processing of the investigation that may need to be acted upon by the assignee.

        • Cd Code [0..1]ExternalAgentInstruction1Code

          Coded information related to the processing of the investigation instruction, provided by the assigner, and intended for the assignee.

        • InstrInf Instruction Information [0..1]Max140Text

          Further information complementing the coded instruction or instruction to the assignee.

      • 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 camt.087 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 camt.087

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

camt.087 questions

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