Panel Giriş API Anahtarlarını Al

Tahsilat Metodu

Taksit Servisi

Üye işyerinize tanımlı taksit seçeneklerini ve komisyon oranlarını sorgulayın: tarihe göre genel tablo ya da kart numarasına göre tutarlı taksit listesi.

Tarih ile Taksit ve Komisyon Sorgulama

Belirli bir tarih için üye işyerinize ait taksit seçeneklerini, komisyon oranlarını ve artı taksit kampanyalarını döner.

TESTPOST https://paynkolaytest.nkolayislem.com.tr/Vpos/Payment/GetMerchandInformation

PRODPOST https://paynkolay.nkolayislem.com.tr/Vpos/Payment/GetMerchandInformation

ParametreZorunluAçıklama
sx✅Size özel satış sx değeriniz (panelden alınır)
date✅Sorgu tarihi — DD.MM.YYYY (ör. 31.12.2026)
hashDatav2✅Aşağıdaki formülle üretilen imza
Hash Formülü
hashDatav2 = Base64(SHA512(sx | date | merchantSecretKey))
Örnek Yanıt (kısaltılmış)
{
  "PLUS_INSTANLMENT_LIST": [
    { "BANK_CODE": "000", "EXTRA_INSTALMENT_DESCRIPTION": "Bireysel Axess kartlarına 2-9 taksit arasında yapılan işlemlere artı 3 taksit verilecektir.", "ACTIVE": true }
  ],
  "COMMISSION_LIST": [
    { "CODE": "PARAF", "KEY": "008", "DATA": [
      { "INSTALLMENT": 1, "COMMISSION": "1.30", "CARD_TRX_TYPE": "TEKCEKIM", "MERCHANT_COMMISSION_RATE": 10 },
      { "INSTALLMENT": 2, "COMMISSION": "4.00", "CARD_TRX_TYPE": "TAKSITLI", "MERCHANT_COMMISSION_RATE": 0 }
    ]}
  ],
  "RESPONSE_CODE": 2,
  "RESPONSE_DATA": null
}

Kart Bilgisi ile Taksit ve Tutar Sorgulama

Kart numarası (ya da ilk 8 hane / BIN) ve tutarla; o karta ait taksit seçeneklerini, taksit tutarlarını ve komisyon dahil çekilecek toplam tutarı (AUTHORIZATION_AMOUNT) döner. Yanıttaki her taksit satırının kendi EncodedValue değeri vardır — müşterinin seçtiği satırın değeri, ödemeyi başlatmak için Payment servisine gönderilir.

TESTPOST https://paynkolaytest.nkolayislem.com.tr/Vpos/Payment/PaymentInstallments

PRODPOST https://paynkolay.nkolayislem.com.tr/Vpos/Payment/PaymentInstallments

ParametreZorunluAçıklama
sx✅Size özel satış sx değeriniz
amount✅İşlem tutarı (ör. 10.04)
cardNumber✅Tam kart numarası ya da ilk 8 hane (BIN)
iscardvalid❌true → tam kart numarasıyla; false ya da boş → yalnız BIN ile sorgular
hosturl❌Sitenizin adresi
Örnek Yanıt (kısaltılmış)
{
  "PAYMENT_BANK_LIST": [
    { "INSTALLMENT": 1, "INSTALLMENT_AMOUNT": 10.17, "CARD_TRX_TYPE": "TEKCEKIM",
      "TRANSACTION_AMOUNT": 10.04, "AUTHORIZATION_AMOUNT": 10.17,
      "COMMISION": 1.3, "COMMISION_AMOUNT": 0.13,
      "MERCHANT_COMMISSION_RATE": 1.3, "MERCHANT_COMMISSION_AMOUNT": 0.13,
      "EncodedValue": "UnBVK2tLNDYzbjZ2OE5VZ3Y3Vzl3MlRKTmVlZnlOdm1FNi9H...",
      "PROGRAM": "005", "CURRENCY_CODE": "TRY" },
    { "INSTALLMENT": 3, "INSTALLMENT_AMOUNT": 3.53, "CARD_TRX_TYPE": "TAKSITLI",
      "TRANSACTION_AMOUNT": 10.04, "AUTHORIZATION_AMOUNT": 10.59,
      "EncodedValue": "elYvRWN6cExJa0RpLy8wRHdoZmFiUk02VmRHRjc2bW82czZz..." }
  ],
  "RESPONSE_CODE": 2,
  "RESPONSE_DATA": "İşlem Başarılı."
}

Yanıttaki PROGRAM alanının hangi kart programına karşılık geldiğini Banka Kodları sayfasında bulabilirsiniz.

Komisyon ve Vade Farkı Alanları

İki servisin yanıtlarındaki komisyon alanları iki farklı tarafı ifade eder:

AlanAçıklama
COMMISIONNkolay'ın üye işyerine uyguladığı komisyon oranı (%)
COMMISION_AMOUNTNkolay'ın üye işyerine uyguladığı komisyon tutarı
MERCHANT_COMMISSION_RATEÜye işyerinin kart sahibine uygulayacağı vade farkı oranı (%)
MERCHANT_COMMISSION_AMOUNTÜye işyerinin kart sahibine uygulayacağı vade farkı tutarı

Alan adı değişikliği: GetMerchandInformation yanıtındaki MERCHANT_COMMISSION alanı artık MERCHANT_COMMISSION_RATE olarak döner; PaymentInstallments yanıtındaki taksit satırlarına MERCHANT_COMMISSION_RATE ve MERCHANT_COMMISSION_AMOUNT alanları eklenmiştir.

Son güncelleme: 5 Eylül 2026

v3 · Versiyonlar