Sign in

v1

latestOpenAPI 3.0.1Creative Commons Attribution 4.0 International Public License2026-07-1334289536.7 KB
Confirmation of Funds Service (PIIS)

Confirmation of funds request

Creates a confirmation of funds request at the ASPSP. Checks whether a specific amount is available at point of time of the request on an account linked to a given tuple card issuer(TPP)/card number, or addressed by IBAN and TPP respectively. If the related extended services are used a conditional Consent-ID is contained in the header. This field is contained but commented out in this specification.

post/v1/funds-confirmations

Headers

X-Request-IDstring required

ID of the request, unique to the call, as determined by the initiating party.

Authorizationstring

Authorization by OAuth2 based Protocol.

This field might be used in case where a consent was agreed between ASPSP and PSU through an OAuth2 based protocol, facilitated by the TPP.

Digeststring

Is contained if and only if the "Signature" element is contained in the header of the request.

Signaturestring

A signature of the request by the TPP on application level. This might be mandated by ASPSP.

TPP-Signature-Certificatestring byte

The certificate used for signing the request, in base64 encoding. Must be contained if a signature is contained.

Request body

cardNumberstring

Card Number of the card issued by the PIISP. Should be delivered if available.

payeestring

Name payee.

Example request

{
  "account": {
    "iban": "FR7612345987650123456789014",
    "otherAccountIdentification": "90-100100-0",
    "currency": "EUR"
  },
  "instructedAmount": {
    "currency": "EUR",
    "amount": "123"
  }
}

Response

OK

fundsAvailableboolean required

Equals true if sufficient funds are available at the time of the request, false otherwise.

This datalemenet is allways contained in a confirmation of funds response.

This data element is contained in a payment status response, if supported by the ASPSP, if a funds check has been performed and if the transactionStatus is "ACTC", "ACWC" or "ACCP".