Skip to main content

Yapı Kredi Virtual POS

You can follow the steps below to complete the Yapı Kredi 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

Since this virtual POS performs IP verification, you need to register your IP with the bank. To do this, click the Technical Information button in the top-right corner on the same page.

Virtual POS Settings in Panel

2. Obtaining the Required Information

Next, you need to log in to the Yapı Kredi Virtual POS Management Screen.

  • You can request live environment credentials from your bank. The information provided will be in the form of Company Code/Customer Code, User Code, and Password. Using the corporate login menu, log in to the bank management panel screen with the provided credentials.
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 MID (Merchant ID)
  • Virtual POS TID (Merchant Terminal Number)
  • Virtual POS API Username
  • Virtual POS Encryption Key (EncKey)

2.1. Steps to Follow in the Yapı Kredi Panel

  • After entering the virtual POS management screen, click on the Posnet/My Information section under the Merchant menu in the top menu.
Virtual POS Settings in Panel
  • Then click on the "My Merchant Information" section under the Transactions heading.
Virtual POS Settings in Panel
  • On the screen that opens, select the "Terminal Number" information and click the Continue button.
Virtual POS Settings in Panel

The information you will need from the My Merchant Information section:

  • Posnet ID
  • Merchant Number
  • Terminal Number
  • 3DS Merchant Key
Virtual POS Settings in Panel
  • After obtaining this information from the Yapı Kredi panel, switch to the serB2B admin panel.

2.2. Steps to Follow in the serB2B Panel

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

Login Screen

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

Login Screen

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

Login Screen

  • Paste the Virtual POS Encryption Key (EncKey) 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 Yapı Kredi from the Bank POS field.
FieldDescription
Field 1Virtual POS MID (Merchant ID)
Field 2Virtual POS TID (Merchant Terminal Number)
Field 3Virtual POS API Username
Field 4Virtual POS Encryption Key (EncKey)
Currency CodeThe Virtual POS currency information must be entered as follows:
- TL for TRY
- USD for USD
- EUR for EUR

4. Common Virtual POS Errors

Important Information About Yapı Kredi Virtual POS Integration

When starting the Yapı Kredi Virtual POS integration, you must contact the bank. In this conversation, you need to clarify how the 'amount' (price) information will be returned to you. That is, whether the amount will be sent in kuruş (multiplied by 100) or in its normal form (not multiplied) must be configured by the bank.

This setting is of critical importance for your payment transactions to proceed without errors. Clarifying this detail with the bank before starting the integration process will prevent potential errors and integration problems that may occur later.