---
title: "Confirmation of funds request"
method: POST
path: "/v1/funds-confirmations"
tags: ["Confirmation of Funds Service (PIIS)"]
---

# Confirmation of funds request

`POST /v1/funds-confirmations`

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.

## Headers

- `X-Request-ID` string, required
- `Authorization` string — Authorization by OAuth2 based Protocol.
- `Digest` string
- `Signature` string
- `TPP-Signature-Certificate` string, byte

## Request body

- ConfirmationOfFunds — JSON Request body for the "Confirmation of funds service". <table> <tr> <td>cardNumber</td> <td>String </td> <td>Optional</td> <td>Card Number of the card issued by the PIISP. Should be delivered if available.</td> </tr> <tr> <td>account</td> <td> Account Reference</td> <td>Mandatory</td> <td>PSU's account number.</td> </tr> <tr> <td>payee</td> <td>Max70Text</td> <td>Optional</td> <td>The merchant where the card is accepted as an information to the PSU.</td> </tr> <tr> <td>instructedAmount</td> <td>Amount</td> <td>Mandatory</td> <td>Transaction amount to be checked within the funds check mechanism.</td> </tr> </table>
  - `cardNumber` string — Card Number of the card issued by the PIISP. Should be delivered if available.
  - `account` AccountReference16CH, required — Reference to an account by either * IBAN, of a payment accounts, or * otherAccountIdentification, for payment accounts if there is no IBAN adapted from ISO pain.001.001.03.ch.02 CashAccount16-CH_IdTpCcy
    - `iban` string — IBAN of an account.
    - `otherAccountIdentification` string — Other payment account Identifier. adapted from ISO pain.001.001.03.ch.02 GenericAccountIdentification1-CH
    - `currency` string — ISO 4217 Alpha 3 currency code.
    - `cashAccountType` string — ExternalCashAccountType1Code from ISO 20022.
  - `payee` string — Name payee.
  - `instructedAmount` Amount, required
    - `currency` string, required — ISO 4217 Alpha 3 currency code.
    - `amount` string, required — The amount given with fractional digits, where fractions must be compliant to the currency definition. Up to 14 significant figures. Negative amounts are signed by minus. The decimal separator is a dot. **Example:** Valid representations for EUR with up to two decimals are: * 1056 * 5768.2 * -1.50 * 5877.78

## Response `200`

OK

- object — Equals "true" if sufficient funds are available at the time of the request, "false" otherwise.
  - `fundsAvailable` boolean, 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".

## Other responses

- `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

---

[API](https://skmtc.net/openbankingproject-ch/apis/swiss-nextgen-banking-api-framework.md) · [All operations](https://skmtc.net/openbankingproject-ch/apis/swiss-nextgen-banking-api-framework/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/openbankingproject-ch/swiss-nextgen-banking-api-framework/versions/c32e86db40b4/schema)