ofOpen Finance Guide
GlossarySTETBlogContact

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" : "2021-11-16T15:30:01.435239+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" : "2021-11-16T15:30:01.435281+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" : "2021-11-16T15:30:01.435281+01:00", "instructedAmount" : { "amount" : 124.35, "currency" : "EUR" }, "beneficiary" : { "creditor" : { "name" : "John Doe", "postalAddress" : { 
 
"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: f042f1d0-26ec-4df9-acaa-14c130431f60 location: /v1/payment-requests/payment-request_rsc2648
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_rsc2648 No specific headers 
 
No body data
8.2.2.2. Response
Status code: 200 Headers
X-Request-Id: 70dd9124-f366-4b9b-a488-5bc4630b3869
Keep-Alive: timeout=60
Connection: keep-alive
8.2.2.3. Body

Note: this body was extracted from a PDF that lost some structural separators (braces / commas). Refer to the source PDF for the canonical JSON.

{ 
 
"paymentRequest" : { 
 
"resourceId" : "payment-request_rsc2648", 
 
- "paymentInformationId" : "MyPmtInfId", 
 
- "creationDateTime" : "2021-11-16T14:30:01.435239Z", 
 
- "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_rsc2649", "requestedExecutionDate" : "2021-11-16T14:30:01.435281Z", "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_rsc2650", "requestedExecutionDate" : "2021-11-16T14:30:01.435281Z", "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", "nextStatusRequestHint" : "2021-11-16T15:35:01.473227+01:00" } }, "_links" : { "request" : { "href" : "/v1/payment-requests/payment-request_rsc2648" }, "confirmation" : { "href" : "/v1/payment-requests/payment-request_rsc2648/confirmation" } } }

8.2.3. Payment Request Confirmation

8.2.3.1. Request
POST http://localhost:18080/v1/payment-requests/payment-request_rsc2648/confirmation Headers 
 
content-length: 22 Body 
 
{ "nonce" : "Nonce56fdd" }
8.2.3.2. Response
Status code: 200 Headers
X-Request-Id: 0278982b-3a62-433b-9feb-fa99715fe4cb
Keep-Alive: timeout=60
Connection: keep-alive
8.2.3.3. Body
{
  "paymentRequest": {
    "resourceId": "payment-request_rsc2648",
    "paymentInformationId": "MyPmtInfId",
    "creationDateTime": "2021-11-16T14:30:01.435239Z",
    "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_rsc2649",
        "requestedExecutionDate": "2021-11-16T14:30:01.435281Z",
        "appliedExecutionDate": "2021-11-16T14:30:01.492825Z",
        "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_rsc2650",
        "requestedExecutionDate": "2021-11-16T14:30:01.435281Z",
        "appliedExecutionDate": "2021-11-16T14:30:01.492924Z",
        "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",
      "nextStatusRequestHint": "2021-11-16T15:35:01.492749+01:00"
    }
  },
  "_links": {
    "request": {
      "href": "/v1/payment-requests/payment-request_rsc2648"
    }
  }
}