ofOpen Finance Guide

Cette page appartient à l'édition 1.5.1.6 de la spécification STET, remplacée depuis par l'édition 1.6.3.1.

Cette page n'est pas traduite : le texte ci-dessous est l'original anglais de la spécification STET.

Lire la même page dans l'édition 1.6.3.1

8.2. Payment Request with multiple instructions having different beneficiaries

8.2.1. Payment Request Submission

8.2.1.1. Request

POST http://localhost:18080/v1/payment-requests?ui_locales=

Headers

content-length: 2529

Body

{
  "paymentInformationId": "MyPmtInfId",
  "creationDateTime": "2020-10-26T08:55:43.655667+01:00",
  "numberOfTransactions": 2,
  "initiatingParty": {
    "name": "MyPreferredPisp",
    "postalAddress": {
      "country": "FR",
      "addressLine": [
        "18 rue de la DSP2",
        "75008 PARIS"
      ]
    },
    "organisationId": {
      "identification": "12FR5",
      "schemeName": "COID",
      "issuer": "ACPR"
    }
  },
  "paymentTypeInformation": {
    "serviceLevel": "SEPA",
    "localInstrument": "INST",
    "categoryPurpose": "CASH"
  },
  "debtor": {
    "name": "MyCustomer",
    "postalAddress": {
      "country": "FR",
      "addressLine": [
        "18 rue de la DSP2",
        "75008 PARIS"
      ]
    },
    "privateId": {
      "identification": "FD37G",
      "schemeName": "BANK",
      "issuer": "BICXYYTTZZZ"
    }
  },
  "chargeBearer": "SLEV",
  "creditTransferTransaction": [
    {
      "paymentId": {
        "instructionId": "MyInstrId3",
        "endToEndId": "MyEndToEndId3"
      },
      "requestedExecutionDate": "2020-10-26T08:55:43.655718+01:00",
      "instructedAmount": {
        "amount": 124.35,
        "currency": "EUR"
      },
      "beneficiary": {
        "creditor": {
          "name": "June Doe",
          "postalAddress": {
            "country": "FR",
            "addressLine": [
              "18 rue de la DSP2",
              "75008 PARIS"
            ]
          },
          "organisationId": {
            "identification": "12FR5",
            "schemeName": "COID",
            "issuer": "ACPR"
          },
          "privateId": {
            "identification": "852126789",
            "schemeName": "SIREN",
            "issuer": "FR"
          }
        },
        "creditorAccount": {
          "iban": "YY49QEZO90424459988701367845944910"
        }
      },
      "ultimateCreditor": {
        "name": "MyPreferredPisp",
        "postalAddress": {
          "country": "FR",
          "addressLine": [
            "18 rue de la DSP2",
            "75008 PARIS"
          ]
        },
        "organisationId": {
          "identification": "12FR5",
          "schemeName": "COID",
          "issuer": "ACPR"
        }
      },
      "purpose": "CASH",
      "remittanceInformation": {
        "unstructured": [
          "MyRemittanceInformation"
        ]
      }
    },
    {
      "paymentId": {
        "instructionId": "MyInstrId4",
        "endToEndId": "MyEndToEndId4"
      },
      "requestedExecutionDate": "2020-10-26T08:55:43.655718+01:00",
      "instructedAmount": {
        "amount": 124.35,
        "currency": "EUR"
      },
      "beneficiary": {
        "creditor": {
          "name": "John Doe",
          "postalAddress": {
            "country": "FR",
            "addressLine": [
              "18 rue de la DSP2",
              "75008 PARIS"
            ]
          },
          "organisationId": {
            "identification": "12FR5",
            "schemeName": "COID",
            "issuer": "ACPR"
          },
          "privateId": {
            "identification": "852126789",
            "schemeName": "SIREN",
            "issuer": "FR"
          }
        },
        "creditorAccount": {
          "iban": "YY49QEZO90424459988701367845944910"
        }
      },
      "ultimateCreditor": {
        "name": "MyPreferredPisp",
        "postalAddress": {
          "country": "FR",
          "addressLine": [
            "18 rue de la DSP2",
            "75008 PARIS"
          ]
        },
        "organisationId": {
          "identification": "12FR5",
          "schemeName": "COID",
          "issuer": "ACPR"
        }
      },
      "purpose": "CASH",
      "remittanceInformation": {
        "unstructured": [
          "MyRemittanceInformation"
        ]
      }
    }
  ],
  "supplementaryData": {
    "acceptedAuthenticationApproach": [
      "REDIRECT",
      "DECOUPLED"
    ],
    "successfulReportUrl": "http://myPisp/PaymentSuccess",
    "unsuccessfulReportUrl": "http://myPisp/PaymentFailure"
  }
}

8.2.1.2. Response

Status code: 201

Headers

X-Request-Id: 6675ba6b-7b0d-4afd-a4b9-f4823c99b284
location: /v1/payment-requests/payment-request_rsc2394
Keep-Alive: timeout=60
Connection: keep-alive

8.2.1.3. Body

{
  "appliedAuthenticationApproach": "REDIRECT",
  "_links": {
    "consentApproval": {
      "href": "https://psd2.aspsp/consent-approval"
    }
  }
}

8.2.2. Payment Request Retrieval

8.2.2.1. Request

GET http://localhost:18080/v1/payment-requests/payment-request_rsc2394

No specific headers

No body data

8.2.2.2. Response

Status code: 200

Headers

X-Request-Id: bb44f410-3cc7-4e4a-b885-d7edc62dd27d
Keep-Alive: timeout=60
Connection: keep-alive

8.2.2.3. Body

{
  "paymentRequest": {
    "resourceId": "payment-request_rsc2394",
    "paymentInformationId": "MyPmtInfId",
    "creationDateTime": "2020-10-26T07:55:43.655667Z",
    "numberOfTransactions": 2,
    "initiatingParty": {
      "name": "MyPreferredPisp",
      "postalAddress": {
        "country": "FR",
        "addressLine": [
          "18 rue de la DSP2",
          "75008 PARIS"
        ]
      },
      "organisationId": {
        "identification": "12FR5",
        "schemeName": "COID",
        "issuer": "ACPR"
      }
    },
    "paymentTypeInformation": {
      "serviceLevel": "SEPA",
      "localInstrument": "INST",
      "categoryPurpose": "CASH"
    },
    "debtor": {
      "name": "MyCustomer",
      "postalAddress": {
        "country": "FR",
        "addressLine": [
          "18 rue de la DSP2",
          "75008 PARIS"
        ]
      },
      "privateId": {
        "identification": "FD37G",
        "schemeName": "BANK",
        "issuer": "BICXYYTTZZZ"
      }
    },
    "debtorAgent": {
      "bicFi": "BNKAFRPPXXX"
    },
    "chargeBearer": "SLEV",
    "paymentInformationStatus": "PDNG",
    "creditTransferTransaction": [
      {
        "paymentId": {
          "instructionId": "MyInstrId3",
          "endToEndId": "MyEndToEndId3"
        },
        "resourceId": "transaction_rsc2395",
        "requestedExecutionDate": "2020-10-26T07:55:43.655718Z",
        "instructedAmount": {
          "amount": 124.35,
          "currency": "EUR"
        },
        "beneficiary": {
          "creditor": {
            "name": "June Doe",
            "postalAddress": {
              "country": "FR",
              "addressLine": [
                "18 rue de la DSP2",
                "75008 PARIS"
              ]
            },
            "organisationId": {
              "identification": "12FR5",
              "schemeName": "COID",
              "issuer": "ACPR"
            },
            "privateId": {
              "identification": "852126789",
              "schemeName": "SIREN",
              "issuer": "FR"
            }
          },
          "creditorAccount": {
            "iban": "YY49QEZO90424459988701367845944910"
          }
        },
        "ultimateCreditor": {
          "name": "MyPreferredPisp",
          "postalAddress": {
            "country": "FR",
            "addressLine": [
              "18 rue de la DSP2",
              "75008 PARIS"
            ]
          },
          "organisationId": {
            "identification": "12FR5",
            "schemeName": "COID",
            "issuer": "ACPR"
          }
        },
        "purpose": "CASH",
        "remittanceInformation": {
          "unstructured": [
            "MyRemittanceInformation"
          ]
        },
        "transactionStatus": "PDNG"
      },
      {
        "paymentId": {
          "instructionId": "MyInstrId4",
          "endToEndId": "MyEndToEndId4"
        },
        "resourceId": "transaction_rsc2396",
        "requestedExecutionDate": "2020-10-26T07:55:43.655718Z",
        "instructedAmount": {
          "amount": 124.35,
          "currency": "EUR"
        },
        "beneficiary": {
          "creditor": {
            "name": "John Doe",
            "postalAddress": {
              "country": "FR",
              "addressLine": [
                "18 rue de la DSP2",
                "75008 PARIS"
              ]
            },
            "organisationId": {
              "identification": "12FR5",
              "schemeName": "COID",
              "issuer": "ACPR"
            },
            "privateId": {
              "identification": "852126789",
              "schemeName": "SIREN",
              "issuer": "FR"
            }
          },
          "creditorAccount": {
            "iban": "YY49QEZO90424459988701367845944910"
          }
        },
        "ultimateCreditor": {
          "name": "MyPreferredPisp",
          "postalAddress": {
            "country": "FR",
            "addressLine": [
              "18 rue de la DSP2",
              "75008 PARIS"
            ]
          },
          "organisationId": {
            "identification": "12FR5",
            "schemeName": "COID",
            "issuer": "ACPR"
          }
        },
        "purpose": "CASH",
        "remittanceInformation": {
          "unstructured": [
            "MyRemittanceInformation"
          ]
        },
        "transactionStatus": "PDNG"
      }
    ],
    "supplementaryData": {
      "acceptedAuthenticationApproach": [
        "REDIRECT",
        "DECOUPLED"
      ],
      "appliedAuthenticationApproach": "REDIRECT",
      "successfulReportUrl": "http://myPisp/PaymentSuccess",
      "unsuccessfulReportUrl": "http://myPisp/PaymentFailure"
    }
  },
  "_links": {
    "request": {
      "href": "/v1/payment-requests/payment-request_rsc2394"
    },
    "confirmation": {
      "href": "/v1/payment-requests/payment-request_rsc2394/confirmation"
    }
  }
}

8.2.3. Payment Request Confirmation

8.2.3.1. Request

POST http://localhost:18080/v1/payment-requests/payment-request_rsc2394/confirmation

Headers

content-length: 22

Body

{
  "nonce": "Nonce56fdd"
}

8.2.3.2. Response

Status code: 200

Headers

X-Request-Id: 0314c734-8150-42c4-a8d0-7560d3eee11f
Keep-Alive: timeout=60
Connection: keep-alive

8.2.3.3. Body

{
  "paymentRequest": {
    "resourceId": "payment-request_rsc2394",
    "paymentInformationId": "MyPmtInfId",
    "creationDateTime": "2020-10-26T07:55:43.655667Z",
    "numberOfTransactions": 2,
    "initiatingParty": {
      "name": "MyPreferredPisp",
      "postalAddress": {
        "country": "FR",
        "addressLine": [
          "18 rue de la DSP2",
          "75008 PARIS"
        ]
      },
      "organisationId": {
        "identification": "12FR5",
        "schemeName": "COID",
        "issuer": "ACPR"
      }
    },
    "paymentTypeInformation": {
      "serviceLevel": "SEPA",
      "localInstrument": "INST",
      "categoryPurpose": "CASH"
    },
    "debtor": {
      "name": "MyCustomer",
      "postalAddress": {
        "country": "FR",
        "addressLine": [
          "18 rue de la DSP2",
          "75008 PARIS"
        ]
      },
      "privateId": {
        "identification": "FD37G",
        "schemeName": "BANK",
        "issuer": "BICXYYTTZZZ"
      }
    },
    "debtorAgent": {
      "bicFi": "BNKAFRPPXXX"
    },
    "chargeBearer": "SLEV",
    "paymentInformationStatus": "ACSC",
    "creditTransferTransaction": [
      {
        "paymentId": {
          "instructionId": "MyInstrId3",
          "endToEndId": "MyEndToEndId3"
        },
        "resourceId": "transaction_rsc2395",
        "requestedExecutionDate": "2020-10-26T07:55:43.655718Z",
        "appliedExecutionDate": "2020-10-26T07:55:43.942774Z",
        "instructedAmount": {
          "amount": 124.35,
          "currency": "EUR"
        },
        "beneficiary": {
          "creditor": {
            "name": "June Doe",
            "postalAddress": {
              "country": "FR",
              "addressLine": [
                "18 rue de la DSP2",
                "75008 PARIS"
              ]
            },
            "organisationId": {
              "identification": "12FR5",
              "schemeName": "COID",
              "issuer": "ACPR"
            },
            "privateId": {
              "identification": "852126789",
              "schemeName": "SIREN",
              "issuer": "FR"
            }
          },
          "creditorAccount": {
            "iban": "YY49QEZO90424459988701367845944910"
          }
        },
        "ultimateCreditor": {
          "name": "MyPreferredPisp",
          "postalAddress": {
            "country": "FR",
            "addressLine": [
              "18 rue de la DSP2",
              "75008 PARIS"
            ]
          },
          "organisationId": {
            "identification": "12FR5",
            "schemeName": "COID",
            "issuer": "ACPR"
          }
        },
        "purpose": "CASH",
        "remittanceInformation": {
          "unstructured": [
            "MyRemittanceInformation"
          ]
        },
        "transactionStatus": "ACSC"
      },
      {
        "paymentId": {
          "instructionId": "MyInstrId4",
          "endToEndId": "MyEndToEndId4"
        },
        "resourceId": "transaction_rsc2396",
        "requestedExecutionDate": "2020-10-26T07:55:43.655718Z",
        "appliedExecutionDate": "2020-10-26T07:55:43.942891Z",
        "instructedAmount": {
          "amount": 124.35,
          "currency": "EUR"
        },
        "beneficiary": {
          "creditor": {
            "name": "John Doe",
            "postalAddress": {
              "country": "FR",
              "addressLine": [
                "18 rue de la DSP2",
                "75008 PARIS"
              ]
            },
            "organisationId": {
              "identification": "12FR5",
              "schemeName": "COID",
              "issuer": "ACPR"
            },
            "privateId": {
              "identification": "852126789",
              "schemeName": "SIREN",
              "issuer": "FR"
            }
          },
          "creditorAccount": {
            "iban": "YY49QEZO90424459988701367845944910"
          }
        },
        "ultimateCreditor": {
          "name": "MyPreferredPisp",
          "postalAddress": {
            "country": "FR",
            "addressLine": [
              "18 rue de la DSP2",
              "75008 PARIS"
            ]
          },
          "organisationId": {
            "identification": "12FR5",
            "schemeName": "COID",
            "issuer": "ACPR"
          }
        },
        "purpose": "CASH",
        "remittanceInformation": {
          "unstructured": [
            "MyRemittanceInformation"
          ]
        },
        "transactionStatus": "ACSC"
      }
    ],
    "supplementaryData": {
      "acceptedAuthenticationApproach": [
        "REDIRECT",
        "DECOUPLED"
      ],
      "appliedAuthenticationApproach": "REDIRECT",
      "appliedAuthentication": "strongAuthentication",
      "successfulReportUrl": "http://myPisp/PaymentSuccess",
      "unsuccessfulReportUrl": "http://myPisp/PaymentFailure"
    }
  },
  "_links": {
    "request": {
      "href": "/v1/payment-requests/payment-request_rsc2394"
    }
  }
}