Camt.027.001.07

Updated on 17 Sep 2024
7 Minutes to read

Print
Share
Dark
Light

Article summary

Did you find this summary helpful?

Thank you for your feedback

This page shows a camt.027.001.07 compliant with SEPA Rulebook 2023.

Camt.027.001.07

The request must include a JSON payload object in the request body. The JSON payload is a camt.027.001.07 ISO message with the clmNonRct root element, and it contains the request details for submitting a payment.

Table: camt.027.001.07.

Message field	Description	Data type	Required/Optional
assgnmt.id	Assignment ID, which must uniquely identify each request you send. This ID is used internally for idempotency of the API.	String	Required
assgnmt.assgnr.agt.finInstnId.bicfi	Assigner's BICFI.	String	Required
assgnmt.assgne.agt.finInstnId.bicfi	Assignee's BICFI.	String	Required
assgnmt.creDtTm	Date and time of the payment request	String	Required
case.id	Identifies the investigation case.	String	Required
case.cretr.agt.finInstnId.bicfi	Case creator's BICFI.	String	Required
undrlyg.intrBk.orgnlGrpInf.orgnlMsgId	Original Message Identification.	String	Required
undrlyg.intrBk.orgnlGrpInf.orgnlMsgNmId	Original Message Name Identification.	String	Required
undrlyg.intrBk.orgnlInstrId	Original Instruction Identification.	String	Optional
undrlyg.intrBk.orgnlEndToEndId	Original End To End Identification.	String	Required
undrlyg.intrBk.orgnlTxId	Original Transaction Identification.	String	Required
undrlyg.intrBk.orgnlIntrBkSttlmDt	Original interbank settlement date.	String	Required
undrlyg.intrBk.orgnlIntrBkSttlmAmt	Data structure containing the amount of money moved between the instructing agent and the instructed agent, as provided in the original instruction. The currency must be EUR and the amount must be a positive value.	Object	Required
undrlyg.intrBk.orgnlTxRef.sttlmInf.clrSys.prtry	Clearing System.	String	Optional
undrlyg.intrBk.orgnlTxRef.sttlmInf.sttlmMtd	Settlement method.	String	Optional
undrlyg.intrBk.orgnlTxRef.pmtTpInf.svcLvl.prtry	Payment scheme type. Value: SEPA	String	Optional
undrlyg.intrBk.orgnlTxRef.pmtTpInf.lclInstrm	Local Instrument. Can be cd or prtry.	Object	Optional
undrlyg.intrBk.orgnlTxRef.rmtInf	Information supplied to enable the matching of an entry with the items that the transfer is intended to settle, such as commercial invoices in an accounts receivable system. Can be strd or ustrd.	Object	Optional
undrlyg.intrBk.orgnlTxRef.dbtrAcct.id.iban	Debtor's name	String	Optional
undrlyg.intrBk.orgnlTxRef.dbtrAgt.finInstnId.bicfi	Debtor's BICFI	String	Optional
undrlyg.intrBk.orgnlTxRef.ultmtDbtr.pty.nm	Ultimate debtor's name	String	Optional
undrlyg.intrBk.orgnlTxRef.ultmtDbtr.pty.id	Ultimate debtor's ID	String	Optional
undrlyg.intrBk.orgnlTxRef.cdtrAcct.id.iban	Creditor's IBAN	String	Optional
undrlyg.intrBk.orgnlTxRef.cdtr.pty.nm	Creditor's name	String	Optional
undrlyg.intrBk.orgnlTxRef.cdtrAgt.finInstnId.bicfi	Creditor's bicfi	String	Optional
undrlyg.intrBk.orgnlTxRef.ultmtCdtr.pty.nm	Ultimate creditor's name.	String	Optional
undrlyg.intrBk.orgnlTxRef.ultmtCdtr.pty.id	Ultimate creditor's ID.	String	Optional
undrlyg.intrBk.orgnlTxRef.purp	Purpose. Can be cd or prtry.	String	Optional
instrForAssgne.cd	Coded information related to the processing of the investigation instruction, provided by the assigner, and intended for the assignee.	String	Optional
instrForAssgne.instrInf	Further information complementing the coded instruction or instruction to the assignee.	String	Optional

Example request body:

{
    "clmNonRct": {
      "assgnmt": {
        "id": "MsgId-pacs008_message",
        "assgnr": {
          "agt": {
            "finInstnId": {
              "bicfi": "PAGOES22XXX"
            }
          }
        },
        "assgne": {
          "agt": {
            "finInstnId": {
              "bicfi": "IPAYESMMXXX"
            }
          }
        },
        "creDtTm": "2023-04-25T13:59:58.020+02:00"
      },
      "case": {
        "id": "cd55171565df31d1a1f60e4f38c7b27c",
        "creator": {
          "agt": {
            "finInstnId": {
              "bicfi": "PAGOES22XXX"
            }
          }
        }
      },
      "Undrlyg": {
        "intrBk": {
          "orgnlGrpInf": {
            "orgnlMsgId": "cd55171565df31d1a1f60e4f38c7b27c",
            "orgnlMsgNmId": "pacs.008.001.08"
          },
          "orgnlEndToEndId": "e2eSTI156316",
          "orgnlTxId": "txIdMBBV201807041659210169778",
          "orgnlTxRef": {
            "intrBkSttlmAmt": {
              "value": 6.66,
              "ccy": "EUR"
            },
            "intrBkSttlmDt": "2022-06-09",
            "sttlmInf": {
              "sttlmMtd": "CLRG",
              "clrSys": {
                "prtry": "TIP"
              }
            },
            "pmtTpInf": {
              "svcLvl": [
                {
                  "cd": "SEPA"
                }
              ],
              "lclInstrm": {
                "cd": "INST"
              }
            },
            "dbtr": {
              "pty": {
                "nm": "Iberpay"
              }
            },
            "dbtrAcct": {
              "id": {
                "iban": "ES2900490001552116244947"
              }
            },
            "dbtrAgt": {
              "finInstnId": {
                "bicfi": "ESPBESMMC02"
              }
            },
            "cdtrAgt": {
              "finInstnId": {
                "bicfi": "PAGOES22XXX"
              }
            },
            "cdtr": {
              "pty": {
                "nm": "Iberpay"
              }
            },
            "cdtrAcct": {
              "id": {
                "iban": "ES8699999999530000000024"
              }
            }
          }
        }
      },
      "InstrForAssgne": {
        "cd": "INQR",
        "instrInf": "Instruction information"
      }
    }
}

Request

The following example illustrates the request using raw HTTP code:

POST /payments/camt027/v07 HTTP/1.1
Host: sandbox.api.pagonxt.com
Content-Type: application/json
Authorization: Bearer YOUR_ACCESS_TOKEN
X-Client-Id: YOUR_CLIENT_ID
sca-token: eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImtpZCI6Ikh1YnRlc3RfcHJvX3NhbmRib3gifQ.eyJoZCI6ImMrMkRKZEUyeklSTkNTS3hMVEU1TnIzVGpmQzRaVUFreTlxM0FuNFZLc3M9Iiwibm9uY2UiOiI2ZGNmOTgyZmM4ZTQ0YmVlOTRiYiIsImFsZyI6IlNIQTI1NiIsImlhdCI6MTY1NDUyNjUyMSwibmJmIjoxNjU0NTI2NTIxLCJleHAiOjE2ODYwNjI1MjEsImp0aSI6IjcwNDJjMjNhLWMzYmItNGU2MS04NjI4LTA1ZDRjODg2MWM0ZSJ9.KqRmUansjP5c-TRg8HcCS65x8I7w6EjT8xDQS83MoYMJiITAX50p1-gtnhtNAD-1l2CdUJfbyV9TzOn7qzm0uXx0rdWOaJ79efV5gEamc3jQNNFfhok9kwwKnlOX5d60UwGfLYbAJdZBZc49eyYRIojacTSVAewcKdXpTbwPPJE140WEYLwWkSXmUCPg1dPNyrogduHGl8DYEPdiaPytty-Bp9H_wApvQ5VAYmu111WzMCI0SPmo-eLGAj20C1sRVgKpl_-Puo-9gT2XOK1EBoD6qG_a2PaPuFxkAcm3W0-NtbEiYFnkvcS8zbMpHjdKq84qmh7Fq9ZsrsKgVJMfug
Content-Length: 3283

{
    "clmNonRct": {
      "assgnmt": {
        "id": "MsgId-pacs008_message",
        "assgnr": {
          "agt": {
            "finInstnId": {
              "bicfi": "PAGOES22XXX"
            }
          }
        },
        "assgne": {
          "agt": {
            "finInstnId": {
              "bicfi": "IPAYESMMXXX"
            }
          }
        },
        "creDtTm": "2023-04-25T13:59:58.020+02:00"
      },
      "case": {
        "id": "cd55171565df31d1a1f60e4f38c7b27c",
        "creator": {
          "agt": {
            "finInstnId": {
              "bicfi": "PAGOES22XXX"
            }
          }
        }
      },
      "Undrlyg": {
        "intrBk": {
          "orgnlGrpInf": {
            "orgnlMsgId": "cd55171565df31d1a1f60e4f38c7b27c",
            "orgnlMsgNmId": "pacs.008.001.08"
          },
          "orgnlEndToEndId": "e2eSTI156316",
          "orgnlTxId": "txIdMBBV201807041659210169778",
          "orgnlTxRef": {
            "intrBkSttlmAmt": {
              "value": 6.66,
              "ccy": "EUR"
            },
            "intrBkSttlmDt": "2022-06-09",
            "sttlmInf": {
              "sttlmMtd": "CLRG",
              "clrSys": {
                "prtry": "TIP"
              }
            },
            "pmtTpInf": {
              "svcLvl": [
                {
                  "cd": "SEPA"
                }
              ],
              "lclInstrm": {
                "cd": "INST"
              }
            },
            "dbtr": {
              "pty": {
                "nm": "Iberpay"
              }
            },
            "dbtrAcct": {
              "id": {
                "iban": "ES2900490001552116244947"
              }
            },
            "dbtrAgt": {
              "finInstnId": {
                "bicfi": "ESPBESMMC02"
              }
            },
            "cdtrAgt": {
              "finInstnId": {
                "bicfi": "PAGOES22XXX"
              }
            },
            "cdtr": {
              "pty": {
                "nm": "Iberpay"
              }
            },
            "cdtrAcct": {
              "id": {
                "iban": "ES8699999999530000000024"
              }
            }
          }
        }
      },
      "InstrForAssgne": {
        "cd": "INQR",
        "instrInf": "Instruction information"
      }
    }
  }

ISO20022 API Specification

Was this article helpful?

What's Next

Camt.087.001.06

Table of contents

ISO20022 API Specification