Arion logo

Confirmation of Funds Service (PIIS)

Confirmation of Funds Service (PIIS) returns a confirmation of funds request at the ASPSP.

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.

SecurityNone or BearerAuthOAuth
Request
header Parameters
X-Request-ID
required
string <uuid>

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

Example: 99391c7e-ad88-49ec-a2ad-99ddcb1f7721
Authorization
string (authorization)

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.

Consent-ID
required
string (consentId)

This then contains the consentId of the related AIS consent, which was performed prior to this payment initiation.

Digest
string

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

Example: SHA-256=hl1/Eps8BEQW58FJhDApwJXjGY4nr1ArGDHIT25vq6A=
Signature
string

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

Example: keyId="SN=9FA1,CA=CN=D-TRUST CA 2-1 2015,O=D-Trust GmbH,C=DE",algorithm="rsa-sha256", headers="Digest X-Request-ID PSU-ID TPP-Redirect-URI Date", signature="Base64(RSA-SHA256(signing string))"
TPP-Signature-Certificate
string <byte>

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

Ocp-Apim-Subscription-Key
required
string

Azure API management subscription key

Request Body schema: application/json
required

Request body for a confirmation of funds request.

cardNumber
string <= 35 characters

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

required
object (accountReference)

Reference to an account by either

  • IBAN, of a payment accounts, or
  • BBAN, for payment accounts if there is no IBAN, or
  • the Primary Account Number (PAN) of a card, can be tokenised by the ASPSP due to PCI DSS requirements, or
  • the Primary Account Number (PAN) of a card in a masked form, or
  • an alias to access a payment account via a registered mobile phone number (MSISDN).
payee
string <= 70 characters

Name payee.

required
object (amount)
Responses
200

OK

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not found

405

Method Not Allowed

406

Not Acceptable

408

Request Timeout

409

Conflict

415

Unsupported Media Type

429

Too Many Requests

500

Internal Server Error

503

Service Unavailable

post/v1/funds-confirmations
Request samples
application/json

Request body for a confirmation of funds.

{
  • "cardNumber": "12345678901234",
  • "account": {
    },
  • "instructedAmount": {
    }
}
Response samples
application/json

Response for a confirmation of funds request.

{
  • "fundsAvailable": "true"
}
➔ Next to Account Information Service (AIS)