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
The Netherlands

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 The Netherlands, 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 Dutch customers are:

- Redirect: Card reader and log-on card, with / without cable

Payment products

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

Corporate mandate

If a countersignature for a payment is necessary as per the Mandate between the Corporate customer and Handelsbanken, please advise the customer to address this within their Online Banking.

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 Dutch Corporates, this is a 6 digit Handelsbanken customer number. If the customer does not know their customer number, they can contact their local branch.

Implementation Guidelines

Within the link below, you’ll find all the payment types that you can offer to our Individual and 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.

Dutch 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
SEPA	Normal	Payment in EUR within the SEPA area. The beneficiary bank must be a SEPA bank.	15:00 CET on working days.	Same day delivery, providing it’s received before the cut-off time.
SEPA	Structured	Payment in EUR within the SEPA area with an RF reference or Acceptgiro 17 reference. The beneficiary bank must be a SEPA bank.	15:00 CET on working days.	Same day delivery, providing it’s received before the cut-off time.
SEPA	Salary	Salary Payment in EUR within the SEPA area. The beneficiary bank must be a SEPA bank. Only for Corporate customers.	15:00 CET on working days.	Same day delivery, providing it’s received before the cut-off time.
Local	Euro express payment	Urgent Payment in EUR within the SEPA area. Only for Corporate customers.	16:00 CET on working days.	If the Euro express payment is authorised before 16:00 CET on the payment date, the beneficiary receives funds the same day. Within the Netherlands the payment will be credited to the beneficiary within 1.5 hours, providing it's received before the cut-off time.
Cross-border	Normal	Any payment outside the SEPA area or a payment in a currency other than EUR within the SEPA area.	Depends on the currency. Please see Payment information for Private customers (in Dutch only) or Payment information for Corporate customers(in Dutch only).	For processing rules and expected value dates, please see Payment information for Private customers (in Dutch only) or Payment information for Corporate customers(in Dutch only).
Cross-border	Express	Urgent payment outside the SEPA area or a payment in a currency other than EUR within the SEPA area.	Depends on the currency. Please see Payment information for Private customers (in Dutch only) or Payment information for Corporate customers(in Dutch only).	For processing rules and expected value dates, please see Payment information for Private customers (in Dutch only) or Payment information for Corporate customers(in Dutch only).