Panel Giriş Başvurun
Tahsilat Metodu

Ön Provizyon

Tutarı önce karta bloke eder, işlemi daha sonra onaylayarak tahsil eder ya da iptal ederek blokeyi kaldırırsınız.

Ön Provizyon Nedir?

Ön provizyon (pre-authorization), kart sahibinin hesabından belirli bir tutarın bloke edilmesidir: tutar çekilmez, yalnızca rezerve edilir ve kullanılabilir limitten düşülür. Daha sonra blokeyi onaylayarak (post-authorization) tahsilatı gerçekleştirir ya da iptal ederek kaldırırsınız.

Tipik kullanım örnekleri: otel rezervasyonları, araç kiralama depoziti, kargo öncesi stok teyidi, sipariş hazırlığında tutarın garanti altına alınması.

Ön provizyon başlatmak için ödeme API'sini transactionType=PRESALES ile çağırmanız yeterlidir — diğer tüm parametreler standart ödemeyle aynıdır.

Onaylanmayan ya da iptal edilmeyen ön provizyonlar, bankaya bağlı olarak genellikle 15–30 gün içinde kendiliğinden düşer. Yine de müşteri deneyimi açısından erken iptal her zaman daha doğrudur.

Ön Provizyon Listeleme

Belirli tarih aralığındaki açık ön provizyonları listeler; aralık en fazla 30 gün olabilir. Bu servis sx-list değerini kullanır (satış sx'inden farklıdır — panelinizdeki Ayarlar bölümünden kontrol edin).

TestPOST https://paynkolaytest.nkolayislem.com.tr/Vpos/Payment/PreAuthorizationList

Gövdemultipart/form-data

ParametreTipZorunluAçıklama
sxstring✅Listeleme (sx-list) değeriniz — satış sx'inden farklıdır
startDatestring✅Başlangıç tarihi (YYYY-MM-DD)
endDatestring✅Bitiş tarihi (YYYY-MM-DD) — aralık en fazla 30 gün
hashDatav2string✅İmza — formül: sx|endDate|startDate|merchantSecretKey
Başarılı Yanıt — 200
{
  "RAPOR_LIST": [
    {
      "REFERENCE_CODE": "IKSIRPF433925",
      "TRANSACTION_TYPE": "Ön Provizyon",
      "TRANSACTION_AMOUNT": "16.00000000",
      "BANK_CODE": "AKBANK T.A.Ş.",
      "INSTALLMENT": "1",
      "DATE": "15.05.2025 13:26:46",
      "TRX_DATE": "15.05.2025 00:00:00"
    }
  ],
  "TOTAL_COUNT": 4,
  "RESPONSE_CODE": 2,
  "RESPONSE_DATA": "İşlem başarılı"
}

Ön Provizyon Onaylama

Bloke edilen tutarı tahsil eder (post-authorization).

TestPOST https://paynkolaytest.nkolayislem.com.tr/Vpos/Payment/PreAuthorizationAprove

Gövdemultipart/form-data

ParametreTipZorunluAçıklama
sxstring✅Size verilen sx değeriniz
amountdecimal✅Onaylanacak tutar
referenceCodestring✅Ön provizyon işleminin referans kodu
trxDatestring✅Ön provizyon tarihi (YYYY-MM-DD)
transactionTypestring✅Onaylama için SALE
hashDatav2string✅İmza — formül: sx|trxDate|amount|referenceCode|merchantSecretKey
cardHolderIPstring—Müşterinin IP adresi

Ön Provizyon İptali

Bloke edilen tutarı serbest bırakır.

TestPOST https://paynkolaytest.nkolayislem.com.tr/Vpos/Payment/PreAuthorizationCancel

Gövdemultipart/form-data

ParametreTipZorunluAçıklama
sxstring✅Size verilen sx değeriniz
amountdecimal✅Ön provizyon tutarı
referenceCodestring✅Ön provizyon işleminin referans kodu
trxDatestring✅Ön provizyon tarihi (YYYY-MM-DD)
transactionTypestring✅İptal için cancel
hashDatav2string✅İmza — formül: sx|trxDate|amount|referenceCode|transactionType|merchantSecretKey

Son güncelleme: 3 Eylül 2026

v2 · Versiyonlar