Version 3.0.0

Changes related to version 3.0.0

Payment product

When initiating a payment, you must tell which kind of payment you want to do in the new field paymentProduct of payment initiation request.
The available payment products for a connector are found in the payment options /ob/pis/payments/options/{connectorId}.
The values for this new field are:

• 0: Domestic;
• 1: SEPA;
• 2: CrossBorder.

This field is located at the root of the payment initiation request (partial):

{
  "recipient": {...},
  "debtor": {...},
  "psuUserAgent": "string",
  "paymentProduct": 0|1|2
}

Revamping Docker endpoints

We have revamped the Docker endpoints to improve the readability and to gather related things together.
Here are the matching list of old/new method and endpoints.
Changed methods are bold & italic

Open Banking

Premium: Bank of America

Premium: Citi Institutional

Premium: DeutscheBank

Premium: JP Morgan

Moved AdditionalPropertiesRequested List in payment options

This list of properties that must/may be given to the payment request is now in the context of the payment products (sepaCreditTransfers, instantSepaCreditTransfers, domesticCreditTransfers...).
The structure remains the same.
In the previous version, it was located at the root of the options. For upwards compatibility, the field is still there but it is obsolete.

Partial old structure:

{
  "sepaCreditTransfers":{...}
  "additionalPropertiesRequested": [
    {
      "name": "userId",
      "title": "User ID",
      "required": false,
      "description": "Swedish social security number in the format YYYYMMDDXXXX",
      "template": "^(19|20)\\d{2}[01]\\d[0-3]\\d\\d{4}$"
    }
  ]
}

The new location is sepaCreditTransfers.additionalPropertiesRequested.
Partial:

{
  "sepaCreditTransfers": {
    "paymentInitiationRequestOptions": {...}
    "additionalPropertiesRequested": [
      {
        "name": "userId",
        "title": "User ID",
        "required": false,
        "description": "Swedish social security number in the format YYYYMMDDXXXX",
        "template": "^(19|20)\\d{2}[01]\\d[0-3]\\d\\d{4}$"
      }
    ]
  }
}

Removed DebtorIban field in payment options.

The field DebtorIban located at options structure root is removed in favor of accountIdentification for each payment products (sepaCreditTransfers, instantSepaCreditTransfers, domesticCreditTransfers...).
Example path for SEPA options: sepaCreditTransfers.paymentInitiationRequestOptions.debtor.accountIdentification
Values are

• 0: Required
• 1: Optional
• 2: Unused
  Here is a partial structure of options:

{
  "sepaCreditTransfers": {
     "paymentInitiationRequestOptions": {
       "debtor": {
         "accountIdentification": 0
       }
     }
  }
}