Ön Provizyon Servisleri

Ön Provizyon Nedir? #

Ön provizyon (pre-authorization), kart sahibinin hesabından belirli bir tutarın bloke edilmesi işlemidir. Tutar kart sahibinin hesabından çekilmez, sadece rezerve edilir ve kullanılabilir limitten düşülür. Üye işyeri daha sonra bu bloke edilen tutarı onaylayarak (post-authorization) tahsilatı gerçekleştirir veya iptal ederek blokeyi kaldırır.

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

Ön provizyon işlemi başlatmak için Ödeme Entegrasyon Servisleri sayfasındaki ödeme API'sini transactionType parametresini "PRESALES" olarak göndererek kullanmanız yeterlidir. Diğer tüm parametreler standart ödeme işlemiyle aynıdır. Başlatılan ön provizyon işlemleri, kart sahibinin bankasına bağlı olarak genellikle 15-30 gün içinde otomatik olarak düşer (release). Bu süre içinde onaylanmazsa veya iptal edilmezse banka blokeyi kendiliğinden kaldırır; ancak müşteri açısından erken iptal her zaman daha doğru bir deneyimdir.

Ön provizyon yaşam döngüsü 3 servis ile yönetilir: Listeleme ile mevcut açık ön provizyonları görüntüleyebilir, Onaylama ile bloke edilen tutarı tahsil edebilir, İptal ile blokeyi kaldırabilirsiniz. Tüm servisler multipart/form-data formatında POST edilir ve hash doğrulaması gerektirir. Listeleme servisi için farklı bir sx değeri (sx-list) kullanılır — panelinizdeki Ayarlar bölümünden kontrol ediniz.

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

Ön Provizyon Listeleme #

Belirli bir tarih aralığındaki tüm açık ön provizyon işlemlerini listeler. Başlangıç ve bitiş tarihi arasındaki maksimum aralık 30 gündür. Bu servis sx-list değerini kullanır (satış sx'inden farklıdır).

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

Body multipart/form-data

	Parametre	Değer	Açıklama
	`sx` zorunlu		Listeleme Sx değeriniz (satış sx'inden farklıdır).
	`startDate` zorunlu		Başlangıç tarihi (YYYY-MM-DD).
	`endDate` zorunlu		Bitiş tarihi (YYYY-MM-DD). Başlangıç ile arası maksimum 30 gün olabilir.
	`hashDatav2` zorunlu		Hash değeri (otomatik hesaplanır). Formül: `sx \| endDate \| startDate \| merchantSecretKey` merchantSecretKey: String: Base64 (SHA-512):

Ön Provizyon Onaylama #

Ön provizyonu yapılmış (PRESALES) işlemi tahsilata dönüştürür. Onaylama sonrası tutar kart sahibinin hesabından çekilir. transactionType alanı bu serviste "SALE" olarak gönderilir. Onaylanan tutar, ön provizyon sırasında bloke edilen tutardan küçük olabilir — bu durumda kalan kısım otomatik olarak serbest bırakılır.

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

Body multipart/form-data

	Parametre	Değer	Açıklama
	`sx` zorunlu		Sx değeriniz.
	`amount` zorunlu		Onaylanacak tutar (ön provizyondaki tutardan küçük olabilir).
	`referenceCode` zorunlu		Ön provizyon işleminin referans numarası (IKSIRPF... ile başlar).
	`trxDate` zorunlu		Ön provizyon tarihi (YYYY-MM-DD).
	`transactionType` zorunlu		Onaylama için "SALE".
	`hashDatav2` zorunlu		Hash değeri (otomatik hesaplanır). Formül: `sx \| trxDate \| amount \| referenceCode \| merchantSecretKey` merchantSecretKey: String: Base64 (SHA-512):
	`cardHolderIP` opsiyonel		Müşterinizin IP adresi (IPv4 veya IPv6).

Ön Provizyon İptali #

Ön provizyonu yapılmış (PRESALES) ancak henüz onaylanmamış işlemi iptal eder ve kart üzerindeki blokeyi serbest bırakır. transactionType alanı bu serviste "cancel" olarak gönderilir. Onaylama servisinden farklı olarak iptal hash formülünde transactionType da yer alır.

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

Body multipart/form-data

	Parametre	Değer	Açıklama
	`sx` zorunlu		Sx değeriniz.
	`amount` zorunlu		Ön provizyon tutarı.
	`referenceCode` zorunlu		Ön provizyon işleminin referans numarası (IKSIRPF... ile başlar).
	`trxDate` zorunlu		Ön provizyon tarihi (YYYY-MM-DD).
	`transactionType` zorunlu		İptal için "cancel".
	`hashDatav2` zorunlu		Hash değeri (otomatik hesaplanır). Formül: `sx \| trxDate \| amount \| referenceCode \| transactionType \| merchantSecretKey` merchantSecretKey: String: Base64 (SHA-512):