# 7.15 PUT /transfers/{ID}

Financial Institution to Financial Institution Payment Status Report - pacs.002.001.15

# Contexte

(DFSP -> DFSP, DFSP -> HUB, HUB -> DFSP)

This message is a response to the POST \transfers call initiated by the DFSP who is requesting to proceed with the transfer terms presented in the PUT \quotes. It is the payee DFSPs responsibility to check that the clearing amounts align with the agreed transfer terms, and if all requirements are met, this message is used to lock-in the agreed terms. Once the hub receives this acceptance message, the transfer can no-longer timeout and will be committed. If this transfer is a dependent transfer in a currency conversion, then that currency conversion will be committed at the same time as this transfer.

The cryptographic ILP fulfillment provided in the TxInfAndSts.ExctnConf field, is released by the payee DFSP as an indication to the HUB that the terms have been met.

Voici un exemple de message :

{
"GrpHdr": {
    "MsgId":"01JBVM1CGC5A18XQVYYRF68FD1",
    "CreDtTm":"2024-11-04T12:57:45.228Z"},
"TxInfAndSts":{
    "ExctnConf":"ou1887jmG-l...",
    "PrcgDt":{
        "DtTm":"2024-11-04T12:57:45.213Z"},
    "TxSts":"RESV"}
}

# Détails du message

La composition et l’utilisation de cette API sont décrites dans les sections suivantes :

  1. Éléments de données principaux
    Cette section précise quels champs sont obligatoires, facultatifs ou non pris en charge pour satisfaire les exigences de validation du message.
  2. Détails d’en-tête
    Cette section générale décrit les exigences d’en-tête pour l’API.
  3. Réponses HTTP prises en charge
    Cette section générale décrit les réponses HTTP qui doivent être prises en charge.
  4. Charge utile d’erreur commune
    Cette section générale décrit la charge utile d’erreur fournie dans la réponse HTTP d’erreur synchrone.

# Éléments de données principaux

Voici les éléments de données principaux nécessaires pour satisfaire cette exigence de pratique du marché.

Les couleurs de fond indiquent la classification de l’élément de données.

Clé de type du modèle de données Description
obligatoireCes champs sont obligatoires pour satisfaire les exigences de validation du message.
facultatifCes champs peuvent être inclus facultativement dans le message. (Certains peuvent être obligatoires pour un schéma donné, selon les règles du système.)
non pris en chargeCes champs ne sont pas pris en charge. Les fonctionnalités associées à ces données ne sont pas compatibles avec un schéma Mojaloop ; leur fourniture entraînera un échec de validation du message.


Here is the defined core data element table.

Champ ISO 20022 Modèle de données Description
GrpHdr - GroupHeader113[1..1]Set of characteristics shared by all individual transactions included in the message.
     MsgId - MessageIdentification[1..1]Definition: Point to point reference, as assigned by the instructing party, and sent to the next party in the chain to unambiguously identify the message.
Usage: The instructing party has to make sure that MessageIdentification is unique per instructed party for a pre-agreed period.
     CreDtTm - CreationDateTime[1..1]Date and time at which the message was created.
     BtchBookg - BatchBookingIndicator[0..0]
     NbOfTxs - Max15NumericText[0..0]Specifies a numeric string with a maximum length of 15 digits.
     CtrlSum - DecimalNumber[0..0]
     TtlIntrBkSttlmAmt - ActiveCurrencyAndAmount[0..0]A number of monetary units specified in an active currency where the unit of currency is explicit and compliant with ISO 4217.
     IntrBkSttlmDt - ISODate[0..0]A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format. This representation is defined in "XML Schema Part 2: Datatypes Second Edition - W3C Recommendation 28 October 2004" which is aligned with ISO 8601.
     SttlmInf - SettlementInstruction15[0..0]Only the CLRG: Clearing option is supported.
Specifies the details on how the settlement of the original transaction(s) between the
instructing agent and the instructed agent was completed.
     PmtTpInf - PaymentTypeInformation28[0..0]Provides further details of the type of payment.
     InstgAgt - BranchAndFinancialInstitutionIdentification8[0..0]Unique and unambiguous identification of a financial institution or a branch of a financial institution.
     InstdAgt - BranchAndFinancialInstitutionIdentification8[0..0]Unique and unambiguous identification of a financial institution or a branch of a financial institution.
CdtTrfTxInf - CreditTransferTransaction64[0..0]
SplmtryData - SupplementaryData1[0..1]Additional information that cannot be captured in the structured elements and/or any other specific block.
     PlcAndNm - PlaceAndName[0..1]Unambiguous reference to the location where the supplementary data must be inserted in the message instance.
     Envlp - Envelope[0..1]Technical element wrapping the supplementary data.
Technical component that contains the validated supplementary data information. This technical envelope allows to segregate the supplementary data information from any other information.