Skip to main content

Halkbank Virtual POS

You can follow the steps below to complete the Halkbank Virtual POS integration.

1. Defining a POS in the serB2B Panel​

First, in the serB2B e-commerce admin panel, click on Settings > Payment Settings > + to be directed to the new virtual POS setup screen.

Virtual POS Settings in Panel

2. Obtaining the Required Information​

Next, you need to log in to the Halkbank Virtual POS Panel. Log in at https://sanalpos.halkbank.com.tr/halk/report/user.login.

Virtual POS Settings in Panel

After logging in to the bank panel, you need to obtain the following for integration with your serB2B site:

  • Virtual POS Store Number (Client ID)
  • Virtual POS API Username
  • Virtual POS API User Password

2.1. Steps to Follow in the Halkbank Panel​

  • In the Halkbank virtual POS panel, click the "Management" tab at the top and click "Add New User" from the left menu.
  • On the page that opens, create a new user with the "API User" role. Do not forget to save the information you enter during creation. Because we will use this information in the serB2B panel.

Login Screen

  • After creating the new user, click the "3D Settings" heading from the left panel. On the page that opens, you can see your 3D model. If your 3D Model is not 3D PAY, you need to contact your Halkbank Customer Representative and have your model changed to 3D PAY.

Login Screen

  • After setting your 3D model correctly, click the "Change Security Key" heading on the next line. From the screen that appears, you can obtain or change your 3D Security Key. Do not forget to save your 3D Security Key after you have finished.

Login Screen
  • Do not forget to save your 3D Security Key after you have finished. Now let's switch to the serB2B admin panel.

2.2. Steps to Follow in the serB2B Panel​

  • Paste the Virtual POS Store Number (Client ID) you obtained into the Field 1 area in the serB2B panel.

Login Screen

  • Paste the Virtual POS API Username you obtained into the Field 2 area in the serB2B panel.

Login Screen

  • Paste the Virtual POS API User Password you obtained into the Field 3 area in the serB2B panel.

Login Screen

2.3. Activating the Virtual POS​

  • Enter the defined currency code. For example, enter 949 for Turkish Lira.
  • Click the Save button to save your settings.

3. Virtual POS Configuration Table​

  1. Select Halkbank from the Bank POS field.
FieldDescription
Field 1Virtual POS Store Number (Client ID)
Field 2Virtual POS API Username
Field 3Virtual POS API User Password
Currency CodeThe Virtual POS currency information must be entered as follows:
- 949 for TRY
- 840 for USD
- 978 for EUR