Taksit Servisi

Tarih ile Taksit ve Komisyon 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.

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

Body multipart/form-data

	Parametre	Değer	Açıklama
	`sx` zorunlu		Size özel merchant numaranız (panelinizden alabilirsiniz).
	`date` zorunlu		Sorgu tarihi (DD.MM.YYYY formatında, örn: 31.12.2025).
	`hashDatav2` zorunlu		Hash değeri (otomatik hesaplanır). Formül: `sx \| date \| merchantSecretKey` merchantSecretKey: String: Base64 (SHA-512):

{
  "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,
  "VALOR_DATE": "7",
  "RESPONSE_CODE": 2,
  "RESPONSE_DATA": null
}

{
  "RESPONSE_CODE": 0,
  "RESPONSE_DATA": "Hash bilgisi hatalı."
}

Kart Bilgisi ile Taksit ve Tutar Sorgulama #

Bu servis ile kart numarası (ya da kartın ilk 8 hanesi / BIN) ve tutar bilgisini göndererek, o karta ait güncel taksit seçeneklerini, taksit tutarlarını ve komisyon dahil ödenecek toplam tutarı (AUTHORIZATION_AMOUNT) sorgulayabilirsiniz. Yanıtta dönen EncodedValue değeri, ödemeyi başlatmak için Payment servisine gönderilir.

Sadece BIN numarası (kartın ilk 8 hanesi) ile sorgulamak için iscardvalid parametresi false olarak gönderilmeli ya da hiç gönderilmemelidir. Tam kart numarası ile sorgulamak için true gönderiniz.

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

Body multipart/form-data

	Parametre	Değer	Açıklama
	`sx` zorunlu		Size özel merchant numaranız (panelinizden alabilirsiniz).
	`amount` zorunlu		İşlem tutarı (örn: 10.04).
	`cardNumber` zorunlu		Tam kart numarası ya da kartın ilk 8 hanesi (BIN).
	`iscardvalid` opsiyonel		`true` ise tam kart numarası ile, `false` ise (veya gönderilmezse) sadece BIN ile sorgular.
	`hosturl` opsiyonel		Sitenizin adresi.

{
  "result": {
    "EncodedValue": "eyJBVVRIT1JJWkFUSU9OX0FNT1VOVCI6IjEwLjA0Iiwi...",
    "PAYMENT_SET_LIST": [
      {
        "PAYMENT_BANK_LIST": [
          {
            "BANK_NAME": "AKBANK",
            "BANK_CODE": "046",
            "AMOUNT": "10.04",
            "AUTHORIZATION_AMOUNT": "10.04",
            "INSTALLMENT": 1,
            "CARD_TRX_TYPE": "TEKCEKIM",
            "COMMISION": "0.00",
            "INSTALLMENT_AMOUNT": "10.04",
            "CURRENCY_CODE": "TRY",
            "CURRENCY_NUMBER": "949",
            "PROGRAM": "002",
            "STATE": true
          },
          {
            "BANK_NAME": "AKBANK",
            "BANK_CODE": "046",
            "AMOUNT": "10.04",
            "AUTHORIZATION_AMOUNT": "10.24",
            "INSTALLMENT": 3,
            "CARD_TRX_TYPE": "TAKSITLI",
            "COMMISION": "2.00",
            "INSTALLMENT_AMOUNT": "3.41",
            "CURRENCY_CODE": "TRY",
            "CURRENCY_NUMBER": "949",
            "PROGRAM": "002",
            "STATE": true
          }
        ]
      }
    ]
  },
  "RESPONSE_CODE": 2,
  "RESPONSE_DATA": null
}

{
  "result": null,
  "RESPONSE_CODE": 0,
  "RESPONSE_DATA": "Kart bilgisi hatalı."
}

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