Maintenance Sunday 6th October

On Sunday 6th October from 06:00-09:00 CET, Handelsbanken online services, including our PSD2 APIs, for Sweden and Finland, will experience issues with card information during that time period, purchases will still be able to be executed during the maintenance period.

Handelsbanken Developer Portal

Use Handelsbanken's APIs to create smart and useful apps.
Come and collaborate with us and start testing today.

Collaborate

Create

Reach

Welcome to our Developer Portal

In our Developer Portal, you will find all the info you need regarding our PSD2 APIs, such as how to test them in our Sandbox environment right up to how to access them in our Live environment.

As we provide PSD2 APIs for multiple countries (Sweden, Great Britain, Finland, the Netherlands and Luxembourg), please be sure to read our Country specific documentation for each API, as the account attributes and payment types differ per country.

Our Technical Guidelines are split per API and per SCA Method, so to easily guide you through the required steps (as we know this is the trickiest part!) If you run into any problems, please check the FAQs (found under the Support tab), before sending us a question via the Contact form (as most of the answers can be found there).

We hope that you enjoy exploring our Portal!

Our APIs

The APIs listed below are available as of today. In order to use them with Live Data, you must be a certified TPP according to the PSD2 regulation (EU 2015/2366). If you aren’t a certified TPP, you're more than welcome to try out our APIs in our Sandbox environment, we just need you to create a developer account (which is free of charge) and then you can check out what we’re offering! 

Create an account

 

PSD2 Accounts Information API

 GET /accounts

  "accounts": [
    {
      "accountId": "ae577250-6cf3-11e9-9c41-e957ce7d7d69",
      "iban": "SE5460000000000403333911",
      "bban": "403333911",
      "currency": "EUR",
      "accountType": "Current Account",
      "bic": "HANDSESS",
      "clearingNumber": "6295",
      "name": "Vacation Account",
      "ownerName": "John Smith",
      "_links": {
        "transactions": {
            "href":"/accounts/5a72e1531b6586f34a0d7ce3/transactions"
        }
      }
    },

Our Account Information API provides you with our our mutual customers' account information, balances and transactions. Please visit our product information page to find out more.

Account Information API

 

PSD2 Card Account Information API

 GET /card-accounts

  "cardAccounts": [
    {
      "accountId": "ae577250-6cf3-11e9-9c41-e957ce7d7d69",
      "cards": [ 
        { 
          "maskedPan": "5123********3283" 
        } 
      ], 
      "currency": "SEK",
      "product": "Platinum",
      "creditLimit": { 
        "currency": "SEK", 
        "amount": 2000 
      }, 
      "balances": [  

      "balances":  
    {
      "accountId": "ae577250-6cf3-11e9-9c41-e957ce7d7d69",
      "iban": "SE5460000000000403333911",
      "bban": "403333911",
      "currency": "EUR",
      "accountType": "Current Account",
      "bic": "HANDSESS",
      "clearingNumber": "6295",
      "name": "Vacation Account",
      "ownerName": "John Smith",
      "_links": {
        "transactions": {

Our Card Account Information API provides you with our mutual customers' card information, balances and transactions. Please visit our product information page to find out more.

Card Account Information API



PSD2 Confirmation of Funds API

 POST /funds-confirmations

{
  "cardNumber": 1234567890123456,
  "account": {
    "iban": "SE5460000000000403333911"
  },
  "payee": "ABC LTD",
  "instructedAmount": {
    "currency": "SEK",
    "amount": 33633.25
  }
}

Our Confirmation of Funds API provides you with a quick availability of funds on a given payment account. Please visit our product information page to find out more.

Confirmation of Funds API

PSD2 Payment Initiation API

 POST /payments/{paymentProduct}

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

Our Payment Initiation API enables you to develop solutions to initiate payments and transfers, both domestic and cross-border. Please visit our product information page to find out more.

Payment Initiation API