Installment Service

Querying Installment Information

With this service, you can query the available installment information for a specific date. You can use this service to learn about the installment options and commission rates for your merchant account.

Click to download Postman Collection. You can see the codes of the language you use in Postman Code Snippet.

API Usage

When using this API, the relevant parameters are POSTed as form-data in the Body to https://paynkolaytest.nkolayislem.com.tr/Vpos/Payment/GetMerchandInformation.

• Test Environment Link: https://paynkolaytest.nkolayislem.com.tr/Vpos/Payment/GetMerchandInformation
• Production Environment Link: https://paynkolay.nkolayislem.com.tr/Vpos/Payment/GetMerchandInformation

Request Parameters

Parameter	Type	Required	Description
sx	string	Yes	Your unique merchant number (can be obtained from your panel)
date	string	Yes	Date information (in DD.MM.YYYY format, e.g., 31.12.2025)
hashDatav2	string	Yes	Security hash value

Hash Generation

The hash value is created using the following formula:

hashDatav2 = Base64(SHA512(sx + "|" + date + "|" + merchantSecretKey))

Hash components:

• sx: Your merchant number
• date: Query date (in DD.MM.YYYY format)
• merchantSecretKey: Your unique secret key (can be obtained from your panel)

Response Structure

A successful query returns a response containing the following information:

{
  "PLUS_INSTANLMENT_LIST": [
    {
      "BANK_CODE": "000",
      "BANK_IMAGE_NAME": "akbank.jpg",
      "EXTRA_INSTALMENT_DESCRIPTION": "Bireysel Axess kartlarına 2-9 taksit arasında yapılan işlemlere artı 3 taksit verilecektir.\n",
      "POS_TYPE": "1",
      "ACTIVE": true,
      "ORDER_NO": 1
    }
  ],
  "COMMISSION_LIST": [
    {
      "CODE": "PARAF",
      "DATA": [
        {
          "INSTALLMENT": 1,
          "COMMISSION": "1.72",
          "CARD_TRX_TYPE": "TEKCEKIM",
          "MERCHANT_COMMISSION": 12
        },
        {
          "INSTALLMENT": 2,
          "COMMISSION": "1.00",
          "CARD_TRX_TYPE": "TAKSITLI",
          "MERCHANT_COMMISSION": 0
        },
        {
          "INSTALLMENT": 3,
          "COMMISSION": "5.19",
          "CARD_TRX_TYPE": "TAKSITLI",
          "MERCHANT_COMMISSION": 0
        }
      ],
      "KEY": "008",
      "BIN": null
    },
    {
      "CODE": "AXESS",
      "DATA": [
        {
          "INSTALLMENT": 1,
          "COMMISSION": "1.72",
          "CARD_TRX_TYPE": "TEKCEKIM",
          "MERCHANT_COMMISSION": 0
        },
        {
          "INSTALLMENT": 2,
          "COMMISSION": "1.00",
          "CARD_TRX_TYPE": "TAKSITLI",
          "MERCHANT_COMMISSION": 1
        }
      ],
      "KEY": "002",
      "BIN": null
    },
    {
      "CODE": "BONUS",
      "DATA": [
        {
          "INSTALLMENT": 1,
          "COMMISSION": "1.72",
          "CARD_TRX_TYPE": "TEKCEKIM",
          "MERCHANT_COMMISSION": 0
        }
      ],
      "KEY": "004",
      "BIN": null
    }
  ],
  "MERCHANT_COMMISSION": 0,
  "COMMISSION": 5.00000000,
  "VALOR_DATE": "7",
  "RESPONSE_CODE": 2,
  "RESPONSE_DATA": null
}

Usage Examples

PHP

example.php

<?php
$sx = "YOUR_SX_VALUE";
$date = "31.12.2025"; // GG.AA.YYYY formatında
$merchantSecretKey = "YOUR_MERCHANT_SECRET_KEY";

// Hash oluşturma
$hashString = $sx . "|" . $date . "|" . $merchantSecretKey;
$hashDatav2 = base64_encode(hash('sha512', $hashString, true));

// API isteği
$url = "https://paynkolaytest.nkolayislem.com.tr/Vpos/Payment/GetMerchandInformation";
$data = [
    'sx' => $sx,
    'date' => $date,
    'hashDatav2' => $hashDatav2
];

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
curl_close($ch);

$result = json_decode($response, true);
print_r($result);
?>

.NET

example.cs

using System;
using System.Net.Http;
using System.Security.Cryptography;
using System.Text;
using System.Collections.Generic;
using System.Threading.Tasks;

class Program
{
    static async Task Main()
    {
        string sx = "YOUR_SX_VALUE";
        string date = "31.12.2025"; // GG.AA.YYYY formatında
        string merchantSecretKey = "YOUR_MERCHANT_SECRET_KEY";

        // Hash oluşturma
        string hashString = $"{sx}|{date}|{merchantSecretKey}";
        using (SHA512 sha512 = SHA512.Create())
        {
            byte[] hashBytes = sha512.ComputeHash(Encoding.UTF8.GetBytes(hashString));
            string hashDatav2 = Convert.ToBase64String(hashBytes);

            // API isteği
            using (var client = new HttpClient())
            {
                var content = new FormUrlEncodedContent(new[]
                {
                    new KeyValuePair<string, string>("sx", sx),
                    new KeyValuePair<string, string>("date", date),
                    new KeyValuePair<string, string>("hashDatav2", hashDatav2)
                });

                var response = await client.PostAsync(
                    "https://paynkolaytest.nkolayislem.com.tr/Vpos/Payment/GetMerchandInformation",
                    content
                );

                string result = await response.Content.ReadAsStringAsync();
                Console.WriteLine(result);
            }
        }
    }
}

JavaScript

example.js

const crypto = require('crypto');
const axios = require('axios');
const FormData = require('form-data');

const sx = "YOUR_SX_VALUE";
const date = "31.12.2025"; // GG.AA.YYYY formatında
const merchantSecretKey = "YOUR_MERCHANT_SECRET_KEY";

// Hash oluşturma
const hashString = `${sx}|${date}|${merchantSecretKey}`;
const hashBytes = crypto.createHash('sha512').update(hashString).digest();
const hashDatav2 = hashBytes.toString('base64');

// API isteği
const formData = new FormData();
formData.append('sx', sx);
formData.append('date', date);
formData.append('hashDatav2', hashDatav2);

axios.post('https://paynkolaytest.nkolayislem.com.tr/Vpos/Payment/GetMerchandInformation', formData, {
    headers: formData.getHeaders()
})
.then(response => {
    console.log(response.data);
})
.catch(error => {
    console.error('Error:', error);
});

Python

example.py

import hashlib
import base64
import requests

sx = "YOUR_SX_VALUE"
date = "31.12.2025"  # GG.AA.YYYY formatında
merchant_secret_key = "YOUR_MERCHANT_SECRET_KEY"

# Hash oluşturma
hash_string = f"{sx}|{date}|{merchant_secret_key}"
hash_bytes = hashlib.sha512(hash_string.encode()).digest()
hash_data_v2 = base64.b64encode(hash_bytes).decode()

# API isteği
url = "https://paynkolaytest.nkolayislem.com.tr/Vpos/Payment/GetMerchandInformation"
data = {
    'sx': sx,
    'date': date,
    'hashDatav2': hash_data_v2
}

response = requests.post(url, data=data)
result = response.json()
print(result)