Esc
Start typing to search...

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.

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 #

ParameterTypeRequiredDescription
sxstringYesYour unique merchant number (can be obtained from your panel)
datestringYesDate information (in DD.MM.YYYY format, e.g., 31.12.2025)
hashDatav2stringYesSecurity 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 #

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);
?>

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);
            }
        }
    }
}

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);
});

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)