Skip to main content

Garanti Virtual POS

You can follow the steps below to complete the Garanti 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 Garanti Virtual POS Management Portal. Log in at https://pos.garantibbva.com.tr/web/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 Terminal ID (also the User ID)
  • Virtual POS Merchant ID (Merchant Number)
  • Virtual POS Password
  • Virtual POS 3D Security Key (Secure Key)

2.1. Steps to Follow in the Garanti Panel​

  • In the Garanti Bank virtual POS screen, go to the "Management" section from the menu. Click the "User Reset" button on the left side.
Virtual POS Settings in Panel
  • Activate the PROVAUT user that appears on screen and create a password of at least 8 characters containing uppercase letters, lowercase letters, and numbers. Enter the security code and click the save button.
Virtual POS Settings in Panel
  • Go to the "Change 3D Secure Key" menu under the Management menu. Note the Terminal Number you see here.
  • If 3D Secure usage has been activated by the bank, you also need to set a 3D password on this page. The 3D password must be entered as a 24-byte hex value. To generate a hex password, visit https://codebeautify.org/generate-random-hexadecimal-numbers. (The Length of Hex Numbers must be 48.)
Login ScreenLogin Screen 2
  • After obtaining this information from the Garanti Bank panel, switch to the serB2B admin panel.

2.2. Steps to Follow in the serB2B Panel​

  • Paste the Virtual POS Terminal ID (also the User ID) you obtained into the Field 1 area in the serB2B panel.

Login Screen

  • Paste the Virtual POS Merchant ID (Merchant Number) you obtained into the Field 2 area in the serB2B panel.

Login Screen

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

Login Screen

  • Paste the Virtual POS 3D Security Key (Secure Key) you obtained into the Field 4 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 Garanti from the Bank POS field.
FieldDescription
Field 1Virtual POS Terminal ID (also the User ID)
Field 2Virtual POS Merchant ID (Merchant Number)
Field 3Virtual POS Password
Field 4Virtual POS 3D Security Key (Secure Key)
Currency CodeThe Virtual POS currency information must be entered as follows:
- 949 for TRY
- 840 for USD
- 978 for EUR

IMPORTANT NOTE​

info

If you receive the "Merchant Usage Type Not Supported" error message during an order, notify your bank that the 3D payment type needs to be changed to 3DPAY. You are receiving this error because the Visa and Mastercard assignment processes for your virtual POS are still ongoing.

Contact and Support​

If you encounter any issues or need assistance, please contact us at [email protected]. We will be happy to help you as soon as possible.