Esc
Aramaya başlamak için yazın...

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.

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 #

ParametreTipZorunluAçıklama
sxstringEvetSize özel merchant numaranız (panelinizden alabilirsiniz)
datestringEvetTarih bilgisi (GG.AA.YYYY formatında, örn: 31.12.2025)
hashDatav2stringEvetGü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 #

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)