Card

Card API'leri, Payantis Platformunda kart için oluşturma işleminden başlayarak kartın yaşam döngüsündeki tüm süreçlere dair fonksiyonları sağlar.

Kartın Özellikleri

API'leri kullanmaya başlamadan önce bir kartın ana özelliklerini bilmek yarar sağlar, bu özellikler şöyledir:

Kart Numarası, Token Id, Maskeli Kart No

Bir kart kart ister fiziksel olsun, ister sanal olsun mutlaka bir numaraya sahiptir. Bu numara çoğunlukla 16 hanelidir. Kart Numarası ödeme sistemleri güvenlik kuralları gereği herhangi bir ortamda açık bir şekilde kullanılamaz ve saklanamaz, müşterinin kendisinden başkası tarafından bilinemez. Bir kart oluşturulduğu anda kart numarası ile birlikte bir Token Id üretilir ve kartın tüm yaşam döngüsü boyunca yapılacak işlemlerde bu token id kullanılır. Öte yandan operasyonel işlemlerde kolaylık olması açısından kart numarasının ilk 6 ve son 4 hanesinin açık olduğu, ortadaki 6 hanenin * işareti ile maskelendiği bir numara da kullanılır ve buna Maskeli Kart No denir ve maskeli kart no servisler ve işlemlerde kullanılabilir.

Kartın Müşterisi

Payantis Platform'da her isimli kart bir müşteri ile ilişkilidir. Bu nedenle kart oluşturmadan önce müşteri kaydının oluşturulmuş olması beklenir. İsimsiz kartlar ise müşterisi olmadan genellikle toplu bir şekilde oluşturulurlar ve kart-müşteri ilişkisi sonradan kurulur. Bazı kart işlemlerinde müşteriye ait bilgiler kullanılabilir, örneği yeni bir kart oluşturulduğunda kart, kendisine sahip olan müşterinin adresine gönderilir.

Kart Güvenlik Bilgileri

Kartın güvenlik bilgileri PIN (şifre), CVV2 (Güvenlik Kodu) ve Vade Tarihi'dir. Bu bilgiler kart oluşturulması sırasında Payantis Platform tarafından güvenli bir şekilde belirlenir. PIN ve CVV2 hiç bir ortamda saklanmaz, vade tarihi ise açık bir şekilde saklanır ve ihtiyaç anında kullanılabilir. Kartın PIN'i müşteri tarafından belirlenebilir, dolayısı ile Payantis Platform'da geçici olarak üretilen PIN bilgisi müşteri tarafından değiştirilmelidir. PIN değiştirme işlemi Kurum'un kanallarından (Internet bankacılığı, mobil uygulama, vb) yapılabileceği gibi herhangi bir bankanın ATM'sinden de değiştirilebilir. Payantis Platform'da PIN işlemlerinin yapılabileceği API'ler bulunmaktadır. PIN API'lerinin güvenli bir şekilde çağrılabilmesi için PIN bilgisi şifrelenir, bu şifreleme işlemi için Payantis ile Kurum arasında karşılıklı güvenlik anahtarları paylaşılır.

Kartın Temel Yetkileri

Payantis Platformda kart bazında belirlenebilen ve genellikle müşterilere değiştirme imkanı verilen temel yetkiler bulunur. Bu yetkiler Card Policy olarak adlandırılır ve yurtiçi/yurtdışı ayrımında para çekme, mail order, e-ticaret, temassız, kumar/bahis ve yarı güvenli e-ticaret işlemleri olarak sınıflandırılır.

Ürün Kodu

Kartlar oluşturulurken mutlaka bir ürün kodu ile oluşturulur. Kart bir çok özelliğini (numarası, vadesi, yetkileri, vb) ürün tanımından alır, bu nedenle kartın doğru ürün ile oluşturulması kritik öneme sahiptir.

Kart Statüsü ve Statü Nedeni

Kart Statüsü bir kartın yaşam döngüsü boyunca içinde bulunduğu durumu belirten bir yapıdır. Kartın kullanılabilir olup olmadığını, işlem yapmaya açık mı yoksa kısıtlanmış mı olduğunu ifade eder ve kart operasyonları, güvenlik kontrolleri ve müşteri hizmetleri süreçleri için kritik bir bilgidir. Payantis Platform'da bulunan kart statüleri şunlardır:

PendingActivation: Kart yeni oluşturuldu ve aktif değil.

Active: Kart aktif ve kullanılabilir durumda.

Lost: Müşteri kartını kaybetti ve kart bu nedenle kapalı. Müşteri için yeni bir kart da üretilir.

Stolen: Müşterinin kartı çalınmış ve kart bu nedenle kapalı. Müşteri için yeni bir kart da üretilir.

Suspended: Kart bir nedenden dolayı geçici olarak kapatılmış durumda.

Closed: Kart kapatılmış ve kullanılamaz durumda.

Fraud: Kart sahtekarlık nedeni ile kapatılmış durumda.

Statü Nedeni kartın belirli statüye alınma nedenini açıklayan bir yapıdır. Bir kartın aktif, kapalı, askıya alınmış veya iptal edilmiş olmasının arkasındaki sebebi belirlemek için kullanılır. Müşteri hizmetleri, risk yönetimi ve dolandırıcılık önleme ekipleri için önemli bir bilgi sağlar. Payantis Platform'da bulunan statü nedenleri şunlardır:

CustomerRequest: Müşteri isteği ile

TenantRequest: Kurum talebi/kararı ile

SuspiciousTransaction: Şüpheli işlem tespiti nedeni ile

DeliveryFailed: Kartın teslim edilememesi nedeni ile

SuspectedFraud: Fraud niteliğinde işlem tespiti ile

ClonedCard: Kart bilgisi kopyalanması nedeni ile

FraudulentApplication: Sahte başvuru nedeni ile

Kartların statüleri arasında geçiş sağlanabilir, buna göre statü nedenleri belirlenebilir. Payantis Platform'da kartın şu anki statüsüne göre bir sonraki statüsünün neler olabileceği şu şekildedir:

Kart Statüsü	Geçilebilecek Statü	Kart Statü Nedenleri
`PendingActivation`	`Active, Closed`
`Active`	`Lost, Stolen, Suspended, Closed, Fraud`
`Lost`
`Stolen`
`Suspended`	`Active, Closed, Fraud, Lost, Stolen`	`CustomerRequest, TenantRequest, SuspiciousTransaction`
`Closed`		`CustomerRequest, TenantRequest, DeliveryFailed`
`Fraud`		`SuspectedFraud, ClonedCard, FraudulentApplication, TenantRequest`

Kart API'leri

API	Fonksiyonu
Create Card	Yeni bir kart oluşturur.
Create Noname Card	İsimsiz kart(lar) oluşturur. Bu kartlar henüz herhangi bir müşterisi olmayan kartlardır ve müşteri ilişkisi sonradan kurulur.
Get Card List	Müşteri bilgileri ile kartlar sorgulanır ve kriterlere uygun kartlar listelenir.
Get Card	Bir kartın temel bilgilirini döner.
Get Card Details	Bir kartın tüm bilgilerini döner.
Get Card Policy	Bir kartın işlem izinlerini döner.
Get Card Audits	Bir kart ait geçmiş işlem ve değişiklik kayıtlarını döner.
Get Card Perso Info	Bir kart basım süreci hakkındaki bilgileri döner.
Get Card Delivery Info	Bir kart dağıtım sürecindeki durumunu döner.
Renew Card	Kartın bozulması ve çalışmaz hale gelmesi durumunda yeninden basılmasını sağlar.
Detokenize Card	Kart numarasını şifreli olarak geri döner. Bu şifre ile açık kart numarası bulunabilir.
Link Noname Card To Customer	İsimsiz olarak üretilen bir kartın müşteriye verilerek müşteri sahipliğinde bir karta dönüşmesini sağlar.
Unlink Noname Card	İsimsizken müşteri sahipli bir karta dönüştürülen bir kartın yeniden müşterisiz bir hale getirir.
Update Card Status	Kart statüsünü değiştirmeyi sağlar.
Update Card Policy	Kartın işlem yetkilerini değiştirmeyi sağlar.
Update Digital Slip Type	Kart hamilinin kartı ile yaptığı işlemler sonucu dijital slip (işlem belgesi) alma tercihini değiştirir.
Update Card Phone Number	Kartın cep telefonu bilgisini değiştirir.
Update Customer Cards Status	Bir müşterinin tüm kartları için statü değişikliği yapılabilmesini sağlar.
Get Payantis RSA Public Key	Kurum tarafından şifreli gönderilmesi gereken bilgilerin şifreleneceği anahtarı döner.
Pin - Verify	Kart şifresini kontrol ederek doğru olup olmadığını döner.
Pin - Set	Kart şifresini günceller.
Pin - Change	Kartın eski şifresini kontrol ederek yeni şifre belirlenmesine izin verir.
Pin - Unblock	Kartın şifre blokesini kaldırır.
Pin - Set Random	Rastgele bir kart şifresi belirler.
Pin - Send Via SMS	Müşteriye SMS ile kart şifresini gönderir.
Cvv2 Verify	Kartın Cvv2 bilgisini kontrol ederek doğru olup olmadığını döner.
Cvv2 Get with Expire Date	Sanal kartlar için kartın Cvv2 bilgisi ve vade tarihini döner.
Cvv2 Reset Counters	Hatalı Cvv2 giriş sayısını sıfırlar.

Kartın Özellikleri#

Kart Numarası, Token Id, Maskeli Kart No#

Kartın Müşterisi#

Kart Güvenlik Bilgileri#

Kartın Temel Yetkileri#

Ürün Kodu#

Kart Statüsü ve Statü Nedeni#

Kart API'leri#