Onboarding Handelsbanken GlobalOn-Line with Direct Communication

As a customer of Handelsbanken, using Handelsbanken GlobalOn-Line with Global Gateway SFTP communication, you can send and retrieve bank files between Handelsbanken and Microsoft Dynamics 365 Business Central using the Payment Management Direct Communication service.

This article covers how to set up direct communication between Handelsbanken GlobalOn-Line and Payment Management.


If you use Handelsbanken Netbank Erhverv as your online banking solution, refer to the article Onboarding Bank Connect banks.

To sign up for a Handelsbanken GlobalOn-Line agreement

To establish direct communication between Payment Management and Handelsbanken, you must contact your Cash Management adviser at your bank and request access to the bank's online banking solution, and subscribe to the following services:

  • Handelsbanken Global On-Line
  • Handelsbanken Global Gateway SFTP communication


When the agreement has been approved, you'll receive a letter with an SHB number (agreement no.) and the user number you must use to authenticate the connection from Business Central.

To order bank files from your bank

When the agreement with Handelsbanken GlobalOn-Line has been established, log in to your bank and order the files you want to use. To see which files you need to order, see Handelsbanken GlobalOn-Line.


It can take up to a day before receiving the files, as the files are generated during the night or early morning and not by request.

To set up an SMTP email account

Before you can set up direct communication, the SFTP communication agreement must be established in Business Central for authentication and authorization.

  1. In Business Central, select the icon Search for page or report, enter Set up Email, and select the related link.
  2. Click Next to start setting up the email account.
  3. In the overview of email account types, select "SMTP", and then Next.
  4. Enter the required account information, and select Next.
  5. Select Finish to save the setup and close the assisted guide.


For more detailed information about SMTP email accounts, refer to the Microsoft documentation.

To set up direct communication

When you've received the agreement from Handelsbanken GlobalOn-Line, you can begin the setup of direct communication in Payment Management.

  1. In Business Central, select the icon Search for page or report, enter Bank Account Setup, and select the related link.

  2. Select Next to begin the assisted setup.

  3. On the Bank Accounts page, select an existing bank account, or create a new one by selecting New Bank Account.

  4. In the Communication column, ensure that Direct Communication is selected for the bank account, and then select Next.


    If any bank account information is missing, you may be prompted to verify or update the information.

  5. On the Choose bank system page, select HBISO20022.

  6. On the Create certificate page, fill in the fields as requested. Payment Management will auto-fill in most of the fields with existing information from Business Central. Type in the information that you received in the letter from the bank.

    Agreement No.The Global On-Line agreement number you received in the letter from Handelsbanken. The number is also called the Handelsbanken SHB-number, and it always starts with "33".
    User No.The User No./User ID you received in a letter from Handelsbanken when you signed the Global On-Line agreement.
    PIN CodeYour password to Handelsbanken Global Gateway SFTP. You should use a combination of numbers, letters, and capital letters. Don't use language-specific characters.
  7. Select Next to complete the bank account setup.

When you return to the bank account overview, you'll see the bank account status has changed to Ready. However, you'll not be able to use direct communication before you've received an email from Handelsbanken confirming that the access has been approved.

When you have set up your bank accounts to use direct communication, you can continue the setup of Payment Management by following the recommended steps as specified in the Quick guide to setting up Payment Management.

See also

Supported bank files