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 API FAQs

What happens when an end user cancels on the payment confirmation window?

Please read our technical guidelines below (depending on which SCA method has been used), as we mention this situation:

SCA Decoupled - Step 3

SCA Redirect - Step 2

Is the transactionStatus in the Payment Initiation flow, updated after the user has signed the SCA flow?

No, the transactionStatus is not updated after the end user has signed the payment. It is updated after the executePayment (PUT) operation.

When can we (the TPP) request the status of a payment?

                                                                                                                                                                                    

DescriptionRequest withinDeletion of PaymentId
If the PSU has signed the payment but it has not been executed, the TPP can ask for the status of the payment within 20 minutes. 20 minsMonthly
If the payment is completed, the status of the payment can be asked for up to 24 months. 24 monthsMonthly

Note: When the PaymentId has been deleted, an HTTP 404 will be returned (GET).

Can I use a short term consent?

You can use a short term consent in the PIS flow.

What is the maximum execution date I can set on a Payment?

                                                                                                                                                                                    

Description
For Private individuals, execution date can be set up to 12 months in the future. This means that Handelsbanken will monitor and execute the payment on set date. Payments with execution date "today" will be sent for processing directly after final approval. Payments that are monitored are sent for processing to the bank on the execution date's morning, at 07:15 CET.  
For Corporates, execution date can be set up to 12 months in the future. This means that Handelsbanken will monitor and execute the payment on set date. Payments with execution date "today" will be sent for processing directly after final approval. Payments that are monitored are sent for processing to the bank on the execution date's morning. 

Note: Please note that this is subject to change.