PIS API specific documentation Payments Accounts
Changes from the previous version
This is the change log of the PIS API (Payments Accounts), allowing PSD2-regulated TPPs to initiate payments on behalf of the PSU (in this case the Nordea Business customer) and use other payment services. The top most item is the latest change and the API changes described in it are relative to the version directly below. The current version of the API is 4.0.
Note: In order to keep integrity with other business PIS APIs, Payments Accounts starting service version is 4.0
Version 4.0
Created
- GET
/v4/payments/accounts
Note: We have implemented new endpoint for Payment service providers (PISPs) to get the list of payments accounts.
The initial release supports account information in payment services for PAYMENTS_MULTIPLE scope users.
Please be informed that the given functionality is currently available only in Sandbox and will be introduced to the Production environment at a later date.
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.
The solution enriches the PIS service with account list so the TPPs having the PISP role can receive these account(s) so they can be shown to the PSU prior to the payment initiation. Then the PSU can choose which account to make the payment from. The feature is available for all Nordic countries: Finland, Sweden, Denmark, Norway. Refer to the section API Reference for more information on the end point specification.
API endpoints
The PIS API contains the following endpoint:
| Endpoint | Supported HTTP Methods |
|---|---|
/payments/accounts | GET |
The /payments/accounts endpoint can be used to get the list of accounts that the PSU can use to make a payment, and it supports only GET HTTP method.
Full request and response example can be seen on examples section below.
PIS API examples
Get list of payments accounts
This example shows how to get the list of payments accounts
This endpoint URL has the following form:
GET /payments/accounts HTTP/1.1
This endpoint supports GET HTTP method.
The following cURL can be used to fetch account list from this endpoint.
$ curl 'https://api.nordeaopenbanking.com/business/v4/payments/accounts' -i \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <ACCESS-TOKEN>' \
-H 'Signature: keyId="clientId",algorithm="rsa-sha256",headers="<signature headers>",signature="<signature code>"\
-H 'Date: Wed, 26 Jun 2025 09:29:19 CEST' \
-H 'X-IBM-Client-Id: <Client ID>' \
-H 'X-IBM-Client-Secret: <Client Secret>'
Here is the response for the query above:
{
"group_header": {
"message_identification": "e57727d864d177b7c98cbd2ccfcf1214",
"creation_date_time": "2025-06-26T07:29:19.851111253Z",
"http_code": 200
},
"response": {
"accounts": [
{
"country": "DK",
"account_numbers": [
{
"value": "20001545785605",
"_type": "BBAN_DK"
},
{
"value": "DK8620001545785605",
"_type": "IBAN"
}
],
"currency": "DKK",
"account_name": "Temme Andreasen",
"account_type": "Current",
"_id": "DK20001545785605-DKK"
},
{
"country": "DK",
"account_numbers": [
{
"value": "20001545768360",
"_type": "BBAN_DK"
},
{
"value": "DK0420001545768360",
"_type": "IBAN"
}
],
"currency": "DKK",
"account_name": "Temme Andreasen",
"account_type": "Savings",
"_id": "DK20001545768360-DKK"
},
{
"country": "DK",
"account_numbers": [
{
"value": "4150511634244185",
"_type": "BBAN_DK"
},
{
"value": "DK4150511634244185",
"_type": "IBAN"
}
],
"currency": "DKK",
"account_name": "Anders Andersen",
"account_type": "Current",
"_id": "DK4150511634244185-DKK"
},
{
"country": "DK",
"account_numbers": [
{
"value": "8850515638238536",
"_type": "BBAN_DK"
},
{
"value": "DK8850515638238536",
"_type": "IBAN"
}
],
"currency": "DKK",
"account_name": "Anders Andersen",
"account_type": "Current",
"_id": "DK8850515638238536-DKK"
}
],
}
}