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

Payment Initiation API

Our Payment Initiation API offers a wide range of payments that our mutual customers can initiate through your innovative financial apps.

   "debtorAccount": {
      "value": "401934551",
      "accountType": "BBAN"
    },
    "instructedAmount": {
      "currency": "GBP",
      "amount": 1000.00 
    },
    "paymentTypeInformation": {
      "serviceLevel": {
        "code": "NURG"
      },

 

The benefits of using our APIs

By using this API, you can safely and securely offer payment services to customers, such as:

- Initiate payments
- Initiate transfers
- Initiate cross-border payments
- Get payment status
- Cancellation of payments
- Signing Basket (only valid for Sweden)
- Short term consent (only valid for Sweden and individual)

As we operate in multiple countries, further down this page you'll find links to our country specific pages where you'll find business rules and Implementation Guidelines.

 

Available APIs

We provide two type of APIs, a general API and country specific APIs. However, we are aiming to have just country specific APIs. For Great Britain and Luxemburg we have country specific APIs but for the other countries you have to use the common API. For Great Britain you can, at the moment, use both types but for Luxemburg you can only use the country specific API.

Sweden, Great Britain and The Netherlands: We have one Payments API that supports all three countries.

Great Britain: We have a country specific Payments API for Individual and Corporate customers in Great Britain.

Luxembourg: We have a country specific Payments API for Individual customers in Luxembourg.

All API products can be fount here: All API products

 

Country specific information

As mentioned above, we operate in multiple countries and the payment types available vary depending on which country the accounts are located in. It is very important that you read the Implementation Guidelines, as they provide key details about which fields, formats and values are required for each payment type. To view the country specific information regarding the Payment Initiation API, please click on the links below.

 

Testing our APIs

When you've read through the documentation on this page and are ready to start some testing, please head over to this guide which will take you through the testing, step-by-step: Sandbox testing

 

Implementing our Live APIs

When you've thoroughly tested our APIs and are ready to use our Live PSD2 APIs, you will first need to enroll with us. This can only be done by Third Party Providers that are authorised by their Local Competent Authority. If that applies to you, please follow this guide: Live Data Enrollment

Please note that for Handelsbanken Norway, the PSD2 APIs are handled by a third party service provider where you'll need to separately sign-up and register. The link to their portal can be found in the Country specific section.