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 Payment rules
Finland

Country specific information about our Payment Initiation API and its implementation rules.

 

General Information

Here you'll find useful information regarding our Payment Initiation API for Finland, such as country specific rules, the Implementation Guidelines for all the payment types and general rules for our payment products.

As we operate worldwide, the services we offer are tailored for each market, so it's important to bear in mind that there can be differences between all of the countries and their payment products.

SCA Methods

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

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

Payment products

For Corporate banking customers, we provide SEPA Credit Transfers and Cross-Border Payments.

Payment accounts

Payments cannot be initiated from a non-euro account.

Corporate mandate

Payments that need to be countersigned as per the Mandate between the Corporate customer and Handelsbanken, cannot be initiated using the Payments API.

PSU-Corporate-ID

For Corporate customers, when sending in a request using our POST endpoint, 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).

Allowed list of countries for payments

If a Corporate customer wants to make payments to countries outside of Finland, then they must add them to their approved list within their online banking. This can be achieved by going to the main menu and then clicking "Countries where payments are allowed" (in Finnish: "Maksujen sallitut maat" / in Swedish "Tillåtna länder för betalningar"). The customer then chooses which countries should be added to their list.

If the customer has not added any other countries to their approved list and they try to make a payment to another country using your services, an error will be returned to you stating that the payment has been rejected due to the "Creditor agent country code is missing or invalid".

 

Implementation Guidelines

Within the link below, you’ll find all the payment types that you can offer to our Corporate customers. We also detail what fields, formats and values are required for each payment type.

It's really important that you follow these guidelines to ensure that payments do not get rejected due to incorrect information.

Finnish Implementation Guidelines

 

General payment rules

The table below contains general rules, cut-off times and processing rules, applicable to the payments that you can offer to our mutual customers. 

Payment

Type

General rules

Cut-off time

Processing rules

Local

SEPA

Local or International Payment (EUR within Europe).

Maximum amount agreed with the customer.

19:15 EET on working days for payments to other banks.

Processed the same day, providing it’s received before the cut-off time.

Cross border

Normal / Express payment

International Payment (outside Europe or not in EUR) i.e. non-SEPA.

For EUR payments - maximum amount agreed with the customer.

For non-EUR payments - maximum amount is equivalent to 20 000 EUR.

18:30 EET on working days.

Processed the same day, providing it’s received before the cut-off time.