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

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

Servise gönderilmesi gereken (HEADERS) parametreler şu şekildedir :

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.

Servise gönderilmesi gereken (BODY) parametreler şu şekildedir :

Parametre	Tip	Zorunlu	Açıklama
PartnerBased	bool	Hayır	Eğer kartlar Partner'lik yönetimi kapsamında ortak bir havuzda kayıt edilecekse kullanılmalıdır
PartnerIdentity	string	Evet/Hayır	Partnerlik kapsamında kayıt edilecek ise Partner hesabınızın kimlik bilgisi
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ı
Number	string	Evet	Kart'ın 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

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

JSON

{
    "PartnerBased": false,
    "PartnerIdentity": "",
    "RelationalId1": "1000923",
    "RelationalId2": "",
    "RelationalId3": "",
    "Card": {
        "Nickname": "İş bankası kartım",
        "HolderName": "Emir Selim Tütüncü",
        "Number": "4546711234567894",
        "Month": 12,
        "Year": 2026
    },
    "IncludeDetails": true
}

Servisten dönen parametreler şu şekildedir:

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

JSON

{
    "ErrorCode": 0,
    "Result": true,
    "Message": "",
    "Body": {
        "Name": "İş bankası kartım",
        "CardBin": "444676",
        "CardLastFour": "3623",
        "CardHolderName": "E*i* S*l*m T*t*n*ü",
        "CardNumber": "454671******7894",
        "CardTypeId": 0,
        "CardType": "Visa",
        "Month": 12,
        "Year": 2026,
        "UniqueCode": "hNNqz1Yy2sb59BSKdF1S0pgrwBWvUuNxG8WiVq4T1AgK56FQljAlKQ==",
        "Details": {
            "CardBankId": 53,
            "CardBank": "T.C.ZİRAAT BANKASI A.Ş.",
            "CardBrandId": 2,
            "CardBrand": "Visa",
            "CardFamilyId": 7,
            "CardFamily": "Combo",
            "CardKindId": 1,
            "CardKind": "Bireysel Kart",
            "CardTypeId": 1,
            "CardType": "Credit"
        }
    }
}