ofOpen Finance Guide

Traducción no oficial, realizada por Open Finance Guide a partir de la especificación en inglés publicada por STET. STET no la ha revisado ni aprobado, y solo el texto original es el de referencia.

Leer el original en inglés

8.2. Solicitud de pago con múltiples instrucciones que tienen diferentes beneficiarios

8.2.1. Envío de la solicitud de pago

8.2.1.1. Solicitud

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

Cabeceras

content-length: 2529

Cuerpo

{
  "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": {
            "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. Respuesta

Código de estado: 201

Cabeceras

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. Cuerpo

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

8.2.2. Recuperación de la solicitud de pago

8.2.2.1. Solicitud

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

Sin cabeceras específicas

Sin datos de cuerpo

8.2.2.2. Respuesta

Código de estado: 200

Cabeceras

X-Request-Id: 70dd9124-f366-4b9b-a488-5bc4630b3869
Keep-Alive: timeout=60
Connection: keep-alive

8.2.2.3. Cuerpo

{
  "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. Confirmación de la solicitud de pago

8.2.3.1. Solicitud

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

Cabeceras

content-length: 22

Cuerpo

{
  "nonce": "Nonce56fdd"
}

8.2.3.2. Respuesta

Código de estado: 200

Cabeceras

X-Request-Id: 0278982b-3a62-433b-9feb-fa99715fe4cb
Keep-Alive: timeout=60
Connection: keep-alive

8.2.3.3. Cuerpo

{
  "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"
    }
  }
}