Information on Handelsbanken Payment API version 2

Update regarding V2 Payments API for Swedish customers

Handelsbanken Relaunches Payment API V2

The PIS API version 2 has now been relaunched. This version is identical to the previously released version, with the addition of a new endpoint.

Our Payment API V2 now supports the SEK Credit Transfer endpoint for the new local domestic payment type in Sweden.

In addition, we have introduced a new endpoint for both corporate and private customers: other-bank-domestic-credit-transfer. This endpoint should be used for payments that need to be debited immediately after successfully passing all internal validation checks. We understand that this functionality is important for some Third-Party Providers (TPPs). For more information, please refer to the FAQ for ‘Payments to other Banks’.

Please note that, due to changes to our account offerings, it will no longer be possible to initiate payments to other banks from the account type Allkortskonto.

Important Timeline

We kindly ask you to review the documentation available on our Developer Portal and test your integration in our Sandbox environment.

Please be aware that we will shortly be deprecating PIS API V1 and is scheduled to be decommissioned on the 15th November 2026.

Previously communicated information about SEK Credit transfer (from March 2026)

FAQ SEK Credit Transfer

 

 

Country specific Account rules
Finland

Country specific information about our Account Information API and its implementation rules.

 

Corporate customers

SCA Methods

The strong customer authentication (SCA) methods and security solutions applicable for Finnish Corporate customers are:

- Redirect: Security key card (Nyckelkodkort, Avaintunnuskortti)
- Redirect: Code application (Bekräfta-appen, Vahvista-sovellus)

Payment Accounts

We will deliver PSD2 Payment Accounts for Corporate customers.

PSU-Corporate-ID

When sending in a request using our Consent API, you need to add a "PSU-Corporate-ID" into the header. For Finnish Corporates, this is either their official Business ID (e.g. 1234567-8) or a customer number issued by Handelsbanken Finland (e.g. 1234567890). If a customer does not have a Business ID registered with Handelsbanken, then the customer number issued by Handelsbanken should be used instead.

The number to use is displayed in the Corporate Internet bank settings (in Finnish: Yrityksen tiedot > Asiakastunnus; in Swedish: Företagsinformation > Kund-ID). When you include this number in the header, it is important that you use the same format as per the Internet bank (e.g. if there is a hyphen, it must be included).

Corporate mandate

For the end user / agent (PSU) to be able to access the Corporate customer's account information or make payments, they need to have the appropriate permissions as per the Corporate Internet bank agreement. An end user's permissions can be updated by contacting their local branch.

If the end user / agent (PSU) has permission to view accounts for multiple Corporate customers, the Get Accounts response will include all accounts that they have access to. This means that the accounts listed in the response may belong to multiple Corporate customers, rather than just one.

Attributes for the Accounts API

In the below document you'll find which attributes are applicable for Finnish customers, as well as other rules for Accounts (e.g. the maximum number of transactions).

Accounts API - FI attributes document