PIS Accounts in Payments API specific documentation
Changes from the previous version
This is the change log of the PIS Accounts in Payments API.
Version 5.0
Introducing account information in payment services for PAYMENTS_MULTIPLE scope users:
/v5/payments/accounts
Overview
Payment Initiation Services (PIS) Accounts in Payments API consists of a single endpoint. The PIS API can be used to get a list of accounts usable to initiate payments. This API only supports GET HTTP method.
API Endpoints
The PIS API contains the following endpoints:
| Endpoint | Supported HTTP Methods |
|---|---|
/payments/accounts | GET |
Further details
For further details on payment type field combinations and status codes, recurring payments etc., please refer to the domestic API documentation as well. Also, have a look at the Help Center contents.
PIS Accounts in Payments API examples
Get list of accounts
This example shows how to get list of accounts that can be used to initiate payments.
Note: PSD3/PSR is NOT finalized yet, so there could be changes to the services based on the final wording. We expect that PISP’s (only) will have access to less details on the accounts than AISP’s, but this is uncertain at the time of the relase of the first version of the service.
This endpoint URL has the following form:
https://api.nordeaopenbanking.com/personal/v5/payments/accounts
This endpoint supports the GET HTTP Method.
Here is an example request:
$ curl 'https://api.nordeaopenbanking.com/personal/v5/payments/accounts' -i -X GET \
-H 'X-Nordea-Originating-Host: <host>' \
-H 'X-Nordea-Originating-Date: <now>' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <access_token>' \
-H 'signature: keyId=\"<your_clientapp_keyid>\",algorithm=\"rsa-sha256\",headers=\"(request-target) x-nordea-originating-host x-nordea-originating-date\",signature=\"<generated_signature>"' \
-H 'X-IBM-Client-Id: <your_client_id>' \
-H 'X-IBM-Client-Secret: <your_client_secret>' \
-H 'X-Nordea-Originating-User-Ip: <psu-ip-address>'
And this is how the response looks like:
{
"group_header": {
"message_identification": "ma5beunmndhua50o",
"creation_date_time": "2025-05-12T12:55:39.6659977Z",
"http_code": 200
},
"response": {
"accounts": [
{
"country": "FI",
"account_numbers": [
{
"value": "FI7473834510057469",
"_type": "IBAN"
}
],
"currency": "EUR",
"account_name": "Aino Salo",
"product": "KÄYTTÖTILI",
"account_type": "Current",
"status": "OPEN",
"_id": "FI7473834510057469-EUR"
},
{
"country": "FI",
"account_numbers": [
{
"value": "FI6593857450293470",
"_type": "IBAN"
}
],
"currency": "EUR",
"account_name": "Aino Salo",
"product": "KÄYTTÖTILI",
"account_type": "Current",
"status": "OPEN",
"_id": "FI6593857450293470-EUR"
},
{
"country": "FI",
"account_numbers": [
{
"value": "15903000105518",
"_type": "IBAN"
}
],
"currency": "EUR",
"account_name": "VIZMARUSHA TOREN",
"product": "SHEKKITILI",
"account_type": "Current",
"status": "OPEN",
"_id": "FI3815903000105518-EUR"
},
{
"country": "FI",
"account_numbers": [
{
"value": "15793000105406",
"_type": "IBAN"
}
],
"currency": "EUR",
"account_name": "VIZMARUSHA TOREN",
"product": "SHEKKITILI",
"account_type": "Current",
"status": "OPEN",
"_id": "FI5815793000105406-EUR"
},
{
"country": "FI",
"account_numbers": [
{
"value": "FI6593857450293555",
"_type": "IBAN"
}
],
"currency": "EUR",
"account_name": "Aino Salo",
"product": "KÄYTTÖTILI",
"account_type": "Current",
"status": "OPEN",
"_id": "FI6593857450293555-EUR"
}
]
}
}