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

 

 

Getting started

It's easy to start testing our APIs and integrate them in your own application.
Follow the 5 steps below and you'll be up and running soon.

 

1. Sign up and start exploring our APIs

We recommend that you're always logged into our portal when using it because we have a lot of documentation that is only readable when logged in (and we think it's a better experience when you log in from the beginning!)

Link to login page LogIn

 

2. Register your app

Before you can send a request to our Sandbox, you need to register your app. Once your app has been created, a Client ID will be generated and this Client ID is required to access the Sandbox APIs.

The Client ID is the unique identifier for each of your registered apps and must be submitted with all API calls. All registered apps can be found here: Create and Manage apps

 

3. Implement our APIs

When a Client ID has been obtained, you must then subscribe to the APIs you want to implement.

Once you reach this stage, you are now ready to start using our APIs in your new app!

We suggests you start reading our documentation in the following order:

  1. Read our Technical Guidelines to get a step-by-step guide to complete a request for an acount list, a payment etc.
  2. Read more about all our API products and Country Specific Information (which covers business rules, attributes, implementation guidelines), you can find that here: Handelsbanken APIs
  3. And finally, get into all details, that is, read our Open API specifications: All API products

 

4. Test and verify

In order to ensure that your app is well tested before going live, it is crucial to test the integration with our APIs in the Sandbox.

Link to the Sandbox: Sandbox

 

5. Live data prerequisites

Before you go live, there are some important steps you must have completed in order to be able to access PSD2 API Live Data.

1. Receive authorisation from a Local Competent Authority to become a Third Party Provider (TPP).
2. Receive a PSD2 eIDAS certificate (QWAC) or a UK Open Banking certificate (OBWAC) from a Qualified Trust Service Provider (QTSP).

To access Live Data, please read our guidelines here: Live Data Enrollment