Skip to main content

Ziraat Bankası Virtual POS

You can follow the steps below to complete the Ziraat Bankası 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 Ziraat Bankası Virtual POS Management Screen.

  • After the Ziraat Bankası Virtual POS application is approved, the bank will send the customer an email containing information such as "Store Number", "Username", and "Password". You can call the Support Line provided in the email, provide the Security Number, and receive your password.
  • Once the password is obtained, all the information needed to access the POS Management screen will be complete.
  • Using the information provided in the email, you can log in to the virtual POS definition screen at https://sanalpos2.ziraatbank.com.tr/ziraat/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 Ziraat Bankası Panel​

After entering the virtual POS management screen, go to the User Addition section under Users in the Management menu.

Virtual POS Settings in Panel
  • From the Add New User section, the User Creation screen where user details will be entered will be opened. In the detail screen that opens, mandatory fields must be filled in and the information noted. The created user type must be API User. Otherwise it will not work correctly.
Virtual POS Settings in Panel
  • After entering the virtual POS management screen, go to the 3D Settings section under 3D Secure in the Management menu. The 3D model section on the screen must be set to "3D Pay" rather than 3D. If the 3D model is showing as 3D, you need to contact the Bank to have the model changed to 3D Pay. Click the Update button on the 3D Settings screen to update the new Merchant Number. Note the 3D Key number that appears on screen for entering POS Details.
Virtual POS Settings in Panel
  • After obtaining this information from the Ziraat Bankası panel, 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 Ziraat Bankası from the Bank POS field.
FieldDescription
Field 1Virtual POS Store Number (Client ID)
Field 2Virtual POS API Username
Field 3Virtual POS API Password
Currency CodeThe Virtual POS currency information must be entered as follows:
- 949 for TRY
- 840 for USD
- 978 for EUR