06. How to Request Information about Available Funds

Using XS2A Funds Confirmation Service you can verify if a PSU has enough funds on a particular account.

You must have PSU consent on accessing funds information. Currently there is no possibility to create such a consent through the XS2A interface but it should be possible in the near future as the Berlin Group has announced that API for Funds Confirmation Consents service will be published soon.

Prerequisites

1. Your certificate must contain the PSP role = PSP_IC.
2. If required by the bank, you need to create a funds-confirmation consent before requesting information about available funds. For more information go to 14. How to Create and Authorise a Confirmation of Funds Consent.

Confirmation of Funds Request

Through the /funds-confirmations endpoint you can request a confirmation from a bank if a concrete amount is available on a particular account of a PSU.

Response contains a boolean.

Request

1. Go to /v1/funds-confirmations. 
2. Fill in mandatory data
   
   • Method = POST
   • X-Request-ID = valid UUID

3. Fill in payload. Mandatory elements are account reference and amount.

   Example
   {
     "account": {
       "iban": "LU280019400644750000"
     },
     "instructedAmount": {
       "amount": 100,
       "currency": "EUR"
     },
     "payee": "Test GmbH"
   }

4. Execute the request.

Response

HTTP status code: 200 Ok

Example
{
    "fundsAvailable": true
}