Kart Saklama
Kart bilgilerini güvenle saklayın, sonraki ödemelerde tek dokunuşla kullanın.
Genel Bakış
Kart saklayabilmek için üye işyerinizde kart saklama yetkisinin tanımlı olması gerekir. Kartı 3D Secure bir işlem sonrasında kaydedebileceğiniz gibi, aynı gün 3D Secure ile yapılmış bir işlemi olan kartı sonradan da kaydedebilirsiniz.
Yöntem 1 — Ödeme Sırasında Kayıt
Ödeme servisini çağırırken csCustomerKey (TCKN, cep telefonu, pasaport no ya da size özel en fazla 11 karakterlik tekil bir değer) ve csAutoSave=true gönderirseniz, başarılı işlem sonunda kart otomatik saklanır. İşlem 3D Secure olmalıdır. Opsiyonel csCardAlias ile karta takma ad verebilirsiniz.
Yöntem 2 — Kart Kayıt API
Kartı doğrudan API ile kaydetmek için kullanılır. Kaydın geçerli olması için aynı gün içinde 3D Secure ile yapılmış bir çekimin IKSIRPF referans numarası referanceCode alanında gönderilmelidir.
TestPOST https://paynkolaytest.nkolayislem.com.tr/Vpos/Payment/CardStorageCardRegister
Gövdemultipart/form-data
| Parametre | Tip | Zorunlu | Açıklama |
|---|---|---|---|
| sx | string | ✅ | Size verilen sx değeriniz |
| customerKey | string | ✅ | Müşteri TCKN / cep no / pasaport no |
| cardNumber | string | ✅ | Kart numarası |
| customerName | string | ✅ | Müşteri ad soyad |
| customerAliance | string | ✅ | Kart takma adı (alan adı serviste böyle geçer) |
| expirateMonth / expirationYear | string | ✅ | Son kullanma ayı ve yılı |
| cvv | string | ✅ | Kartın güvenlik kodu |
| referanceCode | string | ✅ | Aynı gün yapılmış 3D Secure çekimin IKSIRPF numarası |
| hashDatav2 | string | ✅ | İmza — formül: sx|cardNumber|cvv|merchantSecretKey |
| cardHolderIP | string | — | Müşterinin IP adresi |
Kayıtlı Kartları Listeleme
Belirli bir müşteriye ait saklı kartları (token bilgileriyle) listeler.
TestPOST https://paynkolaytest.nkolayislem.com.tr/Vpos/Payment/CardStorageCardList
Gövdemultipart/form-data
| Parametre | Tip | Zorunlu | Açıklama |
|---|---|---|---|
| sx | string | ✅ | Size verilen sx değeriniz |
| customerKey | string | ✅ | Müşterinin TCKN / cep no / pasaport numarası |
| hashDatav2 | string | ✅ | İstek imzası |
Kayıtlı Kartı Silme
Müşterinin sakladığı bir kartı sistemden kaldırır. Kart, tranId veya token değerinden biriyle hedeflenir — ikisinden birinin dolu olması yeterlidir.
TESTPOST https://paynkolaytest.nkolayislem.com.tr/Vpos/Payment/CardStorageCardDelete
PRODPOST https://paynkolay.nkolayislem.com.tr/Vpos/Payment/CardStorageCardDelete
| Parametre | Zorunlu | Açıklama |
|---|---|---|
| sx | ✅ | Satış sx değeriniz |
| customerKey | ✅ | Müşteri kimliği (TCKN / cep no / pasaport no) |
| tranId | ✅* | Silinecek kartın tranId değeri (token yerine kullanılabilir) |
| token | ✅* | Silinecek kartın token değeri (tranId yerine kullanılabilir) |
| hashDatav2 | ✅ | Aşağıdaki formülle üretilen imza |
hashDatav2 = Base64(SHA512(sx | customerKey | tranId | token | merchantSecretKey))Yalnızca biriyle silseniz bile boş alanın borusu korunur — ör. token ile silerken sx|customerKey||token|secret. Boru kayarsa servis hashDatav2:error döner.
Son güncelleme: 4 Eylül 2026