1. Yeni Kart

Yeni kart ekleme işlemini sadece sunucularınız (Back-End) üzerinden gerçekleştirmeniz önerilir. Uygulamalarınızdan (Son Kullanıcı) direkt erişim sağlamanız önerilmez.

Yeni Kart Sakla

POST {{Base Adres}}/paywall/card/insurance

Önemli: Kart işlemleri yüksek güvenlikli işlemlerdir. Bu nedenle 'Header' alanında 'apikeyprivate' ve 'apiclientprivate' parametrelerini göndermeniz gerekmektedir. CardWallAPI Adresi

Gerekli header ve istek parametreleri :

Zorunlu header parametreleri

Parametre	Tip	Zorunlu	Açıklama
apikeyprivate	string	Evet	Üye işyeri panelinden temin etmiş olduğunuz Private Key.
apiclientprivate	string	Evet	Üye işyeri panelinden temin etmiş olduğunuz Private Client.

İstek gövdesi parametreleri

Parametre	Tip	Zorunlu	Açıklama
RelationalId1	string	Evet	Kart'ın ilişkilendirilmesi istenen unique bilgi
RelationalId2	string	Hayır	Kart'ın ilişkilendirilmesi istenen unique ikinci bilgi (listeleme anında tüm bilgiler gönderilmelidir)
RelationalId3	string	Hayır	Kart'ın ilişkilendirilmesi istenen unique üçüncü bilgi (listeleme anında tüm bilgiler gönderilmelidir)
Nickname	string	Evet	Kart'ın takma ismi (Örnek: Yüksek limitli kartım)
HolderName	string	Evet	Kart'ın üstündeki kart sahibi adı
CardBin	string	Evet	Kartın ilk 6 hanesi. Banka ve kart tipini tanımlar.
CardLastFour	string	Evet	Kartın son 4 hanesi.
Identity	string	Evet	Kart sahibinin kimlik numarası veya vergi kimlik numarası.
Month	int	Evet	Kart'ın son kullanılma tarihi (ay)
Year	int	Evet	Kart'ın son kullanılma tarihi (yıl) - Parametre 4 karakter olmalıdır
IncludeDetails	boolean	Hayır	Kartın detay bilgileri (Bin, Tip, Marka, Banka vs) dönsün istiyorsanız TRUEolarak göndermelisiniz
PreventDuplicate	bool	Hayır	Aynı kartın tekrar kayıt edilmesini engeller.
PreventDuplicateHours	int	Hayır	Aynı kullanıcının belirli bir merchant'a belirli saat aralığında yeni kart kaydını engeller.

Servise gönderilecek örnek bir JSON dosyası şu şekildedir :

JSON

{
    "RelationalId1": "003", 
    "RelationalId2": null,
    "RelationalId3": null,
    "Card": {
        "Nickname": "test kartı",
        "HolderName": "Test Kartı",
        "CardBin": "41197901",
        "CardLastFour": "6389",
        "Identity": "17654932298",
        "Month": 11,
        "Year": 2040
    },
    "IncludeDetails": true,
    "PreventDuplicate": false, 
    "PreventDuplicateHours": 1 
}

Servisten dönen parametreler şu şekildedir:

Parametreler ve açıklamaları

Parametre	Tip	Açıklama
ErrorCode	int	Hata kodu. İşlem başarılı ise '0' değerini döner.
Result	bool	True ya da false değeri döner. İşlem başarılı iste 'true' değerini döner.
Message	string	İşlem hatalıysa, bu hataya dair belirtilen mesajdır, locale parametresine göre dil desteği sunar.
Body	nesne	İşlem hatalıysa, bu hataya dair detay nesne
Scope	int	Kart'ın hangi alanda kullanılacağını gösteren parametredir
Name	string	Kullanıcının karta verdiği özel isim.
Identity	string	Kart sahibinin kimlik numarası veya vergi kimlik numarası.
CardBin	string	Kart'a ait BIN bilgisi
CardLastFour	string	Kart'ın son 4 hanesi
CardHolderName	string	Kart sahibinin maskeli adı.
CardNumber	string	Maskeli kart numarası. Ekranlarında listeletebilirsiniz.
Expired	bool	Kart'ın son kullanma tarihinin geçtiğini/geçmediğini ifade eder. True gelmesi durumunda o kart ile ödeme alınamaz Scope int
CardTypeId	int	Kart'ın markasını ifade eder. MasterCard, Visa vs
CardType	string	Kart'ın markasını string olarak döner
Month	int	Kartın son kullanma ayı.
Year	int	Kartın son kullanma yılı.
UniqueCode	string	Kart ile ödeme yapılmak istendiğinde kullanılması gereken kart kimliğidir. Bu bilgi belli periyotlarda değişmektedir. Bu nedenle kayıtlı karta ait UniqueCode bilgileri saklanmamalıdır. Her ödeme öncesinde Paywall üzerinden kart listesi alınmalıdır.
Details.CardBankId	int	Kartın ait olduğu bankanın ID değeri.
Details.CardBank	string	Kartın ait olduğu bankanın adı.
Details.CardBrandId	int	Kart markasının ID değeri.
Details.CardBrand	string	Kart markasının adı.
Details.CardFamilyId	int	Kart ailesinin ID değeri.
Details.CardFamily	string	Kart ailesinin adı.
Details.CardKindId	int	Kartın bireysel/kurumsal ayrımının ID değeri.
Details.CardKind	string	Kartın bireysel/kurumsal ayrımı.
Details.CardTypeId	int	Kartın debit/credit/prepaid ayrımının ID değeri.
Details.CardType	string	Kartın debit/credit/prepaid ayrımı.

JSON

{
    "ErrorCode": 0,
    "Result": true,
    "Message": "",
    "Body": {
        "Scope": 2,
        "Name": "test kartı",
        "Identity": "176****298",
        "CardBin": "41197901",
        "CardLastFour": "6389",
        "CardHolderName": "Test Kartı",
        "CardTypeId": 1,
        "CardType": "Credit",
        "Month": 11,
        "Year": 2040,
        "UniqueCode": "PLUg7DMV88LRBnQ2SvssryFDUBmWM2G4wYlT+BEqm1AAPy6BKz+wBA==",
        "Details": {
            "CardBankId": 56,
            "CardBank": "T. VAKIFLAR BANKASI T.A.O.",
            "CardBrandId": 2,
            "CardBrand": "Visa",
            "CardFamilyId": 1,
            "CardFamily": "World",
            "CardKindId": 1,
            "CardKind": "Bireysel Kart",
            "CardTypeId": 1,
            "CardType": "Credit"
        }
    }
}