Kart Saklama

Kart bilgilerini saklayıp, saklı kart ile işlem yapabilirsiniz. #

Üye işyerinin kart saklayabilmesi için kart saklama yetkisi alması gerekmektedir. Kart, 3D secure bir işlem sonrasında kayıt edilebilir. POSTMAN collection içinde ilgili servisler verilmiştir.

Postman collection'ını indirmek için tıklayınız. Örnek kodları Postman Code sinppet'inde görebilirsiniz.

Hash methodu için tıklayınız.

Kartı Kayıt Etme #

Kart kayıt etmek için ödeme servisi çağırılırken “csCustomerKey”, (TC kimlik no, Cep telefon numarası, Passaport numarasını, ya da sizde tekil maksimum 11 karakter bir değer), ve csAutoSave parametresini “true” gönderilmesi ile başarı işlem sonununca kart saklama yapılmaktadır. ( İşlem 3D secure olmalıdır )

csCardAlias parametresi ile kaydedilen karta bir takma ad verebilirsiniz. Bu alan opsiyoneldir; gönderilmezse kart takma adsız kaydedilir.

Kayıtlı Kartları Listeleme #

Belirli bir müşteriye ait saklı kartları listeler. customerKey olarak müşterinin TCKN, cep telefonu veya pasaport numarası gönderilir.

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

Body multipart/form-data

	Parametre	Değer	Açıklama
	`sx` zorunlu		Sx değeriniz.
	`customerKey` zorunlu		Müşteri TCKN / Cep No / Pasaport No.
	`hashDatav2` zorunlu		Hash değeri (otomatik hesaplanır). Formül: `sx \| customerKey \| merchantSecretKey` merchantSecretKey: String: Base64 (SHA-512):

Kayıtlı Kartı Silme #

Silmek istediğiniz kartı, kartın token'ı ile silebilirsiniz. Bunun için önce kart listeleme servisinden ilgili kartın token bilgisini çekmelisiniz.

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

Body multipart/form-data

	Parametre	Değer	Açıklama
	`sx` zorunlu		Sx değeriniz.
	`customerKey` zorunlu		Müşteri TCKN / Cep No / Pasaport No.
	`token` zorunlu		Silinecek kartın token bilgisi (listeleme servisinden alınır).
	`hashDatav2` zorunlu		Hash değeri (otomatik hesaplanır). Formül: `sx \| customerKey \| tranId \| token \| merchantSecretKey` merchantSecretKey: String: Base64 (SHA-512):

Kayıtlı Karttan Ödeme Alma #

Saklı kartın token bilgisi ya da tranid'si ile ödeme alabilirsiniz. Ödeme almak için ilgili parametreler "https://paynkolaytest.nkolayislem.com.tr/Vpos/v1/Payment" adresine Body'de form-data olarak POST edilir. Hash oluşturmak için Request Hash yapısı kullanılmalıdır.