Ö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

Parametre	Tip	Zorunlu	Açıklama
sx	string	✅	Listeleme (sx-list) değeriniz — satış sx'inden farklıdır
startDate	string	✅	Başlangıç tarihi (YYYY-MM-DD)
endDate	string	✅	Bitiş tarihi (YYYY-MM-DD) — aralık en fazla 30 gün
hashDatav2	string	✅	İ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

Parametre	Tip	Zorunlu	Açıklama
sx	string	✅	Size verilen sx değeriniz
amount	decimal	✅	Onaylanacak tutar
referenceCode	string	✅	Ön provizyon işleminin referans kodu
trxDate	string	✅	Ön provizyon tarihi (YYYY-MM-DD)
transactionType	string	✅	Onaylama için SALE
hashDatav2	string	✅	İmza — formül: sx\|trxDate\|amount\|referenceCode\|merchantSecretKey
cardHolderIP	string	—	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

Parametre	Tip	Zorunlu	Açıklama
sx	string	✅	Size verilen sx değeriniz
amount	decimal	✅	Ön provizyon tutarı
referenceCode	string	✅	Ön provizyon işleminin referans kodu
trxDate	string	✅	Ön provizyon tarihi (YYYY-MM-DD)
transactionType	string	✅	İptal için cancel
hashDatav2	string	✅	İmza — formül: sx\|trxDate\|amount\|referenceCode\|transactionType\|merchantSecretKey

Bu sayfa yardımcı oldu mu?

Son güncelleme: 3 Eylül 2026