OpenFinance
Development Portal

openFinance API Framework XS2A API as PSD2 Interface Implementation Guidelines - Extended Payment Initiation Service (2.1)

The Berlin Group - A European Standards Initiative | info@: info@berlin-group.org | URL: https://www.berlin-group.org/

License: Creative Commons Attribution 4.0 International Public License

The specific function in the Extended Payment Initiation Services is to make the initiation phase more flexible, i.e. * separate authorisation and actual initiation processes as well as * unbundle risk management functionality from the actual payment initiation, but already apply e.g. limit and balance checks during the authorisation and hence * potentially secure the future payment initiation in addition.

Get initiation

GET /v2/{extended-payment-service6}/{payment-product}/{paymentId}/initiations/{initiationId}

Returns of all available initiation objects related to a given payment resource.

Parameter Type Description
extended-payment-service6 string , required

Extended Payment Initiation Service. The default list is: * deferred-payments for XDPIS, * secured-deferred-payments for XDFPIS, * multiple-deferred-payments for XMDPIS, * secured-multiple-deferred-payments for XMDFPIS * recurring-payments for XRPIS * secured-recurring-payments for XRFPIS and * multiple-recurring-payments for XMRPIS

Allowed values: deferred-payments, secured-deferred-payments, multiple-deferred-payments, secured-multiple-deferred-payments, recurring-payments, secured-recurring-payments, multiple-recurring-payments

Example: multiple-recurring-payments

payment-product string , required

The addressed payment product endpoint, e.g. for SEPA Credit Transfers (SCT). The ASPSP will publish which of the payment products/endpoints will be supported. The following payment products are supported: - For request bodies with JSON encoding: -- sepa-credit-transfers -- micro-sepa-credit-transfers -- instant-sepa-credit-transfers -- target-2-payments -- cross-border-credit-transfers The ASPSP will publish which of the payment products/endpoints will be supported. For definitions of basic non euro generic products see [oFA PFDom]. Further products might be published by the ASPSP within its XS2A documentation. These new product types will end in further endpoints of the XS2A Interface.

Allowed values: sepa-credit-transfers, micro-sepa-credit-transfers, instant-sepa-credit-transfers, target-2-payments, cross-border-credit-transfers

Example: sepa-credit-transfers

paymentId string , required

Resource identification of the related payment.

Example: fe7552ee-0728-4bd1-baf7-94942331e478

Allowed length: max: 70

initiationId string , required

ID of the corresponding initiation object as returned by a Initiation for Multiple Recurring Payments Request.

Header Type Description
Digest string , optional

Integrity hash of the request body in the form SHA-256=<base64>. For an empty body, use the hash of an empty string. See Signing requests for how the Digest and signature are built.

Example: SHA-256=hl1/Eps8BEQW58FJhDApwJXjGY4nr1ArGDHIT25vq6A=

x-jws-signature string , optional

Detached JSON Web Signature over the signed request headers and body. See Signing requests for how it is constructed.

X-Request-ID string , required

Unique ID of the request, set by the initiating party and echoed back in the response.

Example: 99391c7e-ad88-49ec-a2ad-99ddcb1f7721

Format: uuid

Select a status code to see the structure and an example of the response.

Field Type Description
closingFlag boolean , required

If true, then the TPP indicates that this is the last initiation on the related payment resource. As a consequence, the mechanism for securing the payment (e.g. reservation of funds) is closed in the ASPSP system.

initiationId string , optional

Unique identification of the deferred payment initiation.

transactionFees object , optional

Might be used by the ASPSP to transport the total transaction fees relevant for the underlying payments. This field includes the entry of the "currencyConversionFees" if applicable.

instructedAmount object , optional

Amount requested from the API client to be executed by the ASPSP. Mandatory for XDPIS, XDFPIS, XRPIS and XRFPIS. If not contained in a XMDPIS service, then this is a dedicated closing transaction. This amount shall be smaller or equal to the amount still being reserved in the XDPIS/XDFPIS/XMPIS/XMFPIS case (current reservedAmount)

estimatedTotalAmount object , optional

The amount which is estimated to be debted from the debtor account. Note: This amount includes fees.

currencyConversionFee object , optional

Might be used by the ASPSP to transport specific currency conversion fees related to the initiated credit transfer.

paymentIdentification object , optional

If this attribute is provided, then it will be used by the ASPSP in the related credit transfer for payment identification.

transactionFeeIndicator boolean , optional

If equals "true", the transaction will involve specific transaction cost as shown by the ASPSP in their public price list or as agreed between ASPSP and PSU. If equals "false", the transaction will not involve additional specific transaction costs to the PSU unless the fee amount is given specifically in the data elements transactionFees and/or currencyConversionFees. If this data element is not used, there is no information about transaction fees unless the fee amount is given explicitly in the data element transactionFees and/or currencyConversionFees.

remainingAuthorisedAmount object , required

The amount still available for further following deferred payment initiations. Only used in case of multiple deferred payments.

remittanceInformationStructured array[object] , optional

The supported sub structure will depend on the underlying payment product. If this attribute is provided, then it will be used by the ASPSP in the related credit transfer for remittance information.

remittanceInformationUnstructured array[string] , optional

If this attribute is provided, then it will be used by the ASPSP in the related credit transfer for remittance information.

estimatedInterbankSettlementAmount object , optional

The estimated amount to be transferred to the payee.