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 edebileceğiniz gibi, aynı gün 3D secure ile bir işlemi varsa kart sonradan da kayıt edebilirsiniz. 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.
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ı), ve csAutoSave parametresini "true" gönderilmesi ile başarı işlem sonununca kart saklama yapılmaktadır. ( İşlem 3D secure olmalıdır )
Kart Kayıt API #
Kart bilgilerini doğrudan API üzerinden kaydetmek için bu servisi kullanabilirsiniz. Kayıt işleminin geçerli olabilmesi için aynı gün içinde 3D Secure ile yapılmış bir çekim işleminin IKSIRPF referans numarası referanceCode alanında gönderilmelidir; sistem bu referans üzerinden kayıt yetkisini doğrular.
| Parametre | Değer | Açıklama | |
|---|---|---|---|
sx
zorunlu
|
Sx değeriniz. | ||
customerKey
zorunlu
|
Müşteri TCKN / Cep No / Pasaport No. | ||
cardNumber
zorunlu
|
Kart numarası. | ||
customerName
zorunlu
|
Müşteri ad soyad. | ||
customerAliance
zorunlu
|
Kart takma adı. | ||
expirateMonth
zorunlu
|
Son kullanma ayı (alan adı upstream'de "expirate" olarak geçer). | ||
expirationYear
zorunlu
|
Son kullanma yılı. | ||
cvv
zorunlu
|
Kartın CVV değeri. | ||
referanceCode
zorunlu
|
Aynı gün yapılmış 3D Secure çekim işleminin IKSIRPF numarası (alan adı upstream'de "referance" olarak geçer). | ||
hashDatav2
zorunlu
|
Hash değeri (otomatik hesaplanır). Formül:
sx | cardNumber | cvv | merchantSecretKey
merchantSecretKey:
String:
Base64 (SHA-512):
|
||
cardHolderIP
opsiyonel
|
Müşterinizin IP adresi (IPv4 veya IPv6). |
Kayıtlı Kartları Listeleme #
Belirli bir müşteriye ait saklı kartları listeler. customerKey olarak müşterinin TCKN, cep telefonu veya pasaport numarası gönderilir.
| 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.
| 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 | 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.
