Taksit Servisi

Taksit Bilgisi Sorgulama

Bu servis ile belirli bir tarih için mevcut taksit bilgilerini sorgulayabilirsiniz. Üye işyerinize ait taksit seçeneklerini ve komisyon oranlarını öğrenmek için bu servisi kullanabilirsiniz.

Postman Collection’ını indirmek için tıklayınız. Postman Code Snippet’inde kendi kullandığınız dilin kodlarını görebilirsiniz.

API Kullanımı

Bu API’nin kullanımında, ilgili parametreler https://paynkolaytest.nkolayislem.com.tr/Vpos/Payment/GetMerchandInformation adresine Body’de form-data olarak POST edilir.

• Test Ortam Linki: https://paynkolaytest.nkolayislem.com.tr/Vpos/Payment/GetMerchandInformation
• Canlı Ortam Linki: https://paynkolay.nkolayislem.com.tr/Vpos/Payment/GetMerchandInformation

Request Parametreleri

Parametre	Tip	Zorunlu	Açıklama
sx	string	Evet	Size özel merchant numaranız (panelinizden alabilirsiniz)
date	string	Evet	Tarih bilgisi (GG.AA.YYYY formatında, örn: 31.12.2025)
hashDatav2	string	Evet	Güvenlik hash değeri

Hash Oluşturma

Hash değeri aşağıdaki formül ile oluşturulur:

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

Hash bileşenleri:

• sx: Merchant numaranız
• date: Sorgu tarihi (GG.AA.YYYY formatında)
• merchantSecretKey: Size özel gizli anahtarınız (panelinizden alabilirsiniz)

Response Yapısı

Başarılı bir sorgulamada aşağıdaki bilgileri içeren bir response döner:

{
  "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
}

Kullanım Örnekleri

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)