3. Kayıtlı Kartlar

Kayıtlı kart verilerini sadece sunucularınız (Back-End) üzerinden çekmeniz önerilir. Uygulamalarınızdan (Son Kullanıcı) direkt erişim sağlamanız önerilmez.

Kayıtlı kart listesi

GET {{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 parametreler şu şekildedir :

Parametre (Headers)	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.
relationalid1	string	Evet	Kayıtlı karta ait ilişkilendirilmiş birinci değer
relationalid2	string	Hayır	Kayıtlı karta ait ilişkilendirilmiş ikinci değer
relationalid3	string	Hayır	Kayıtlı karta ait ilişkilendirilmiş üçüncü değer
includedetails	bool	Hayır	Kartın detay bilgileri (Bin, Tip, Marka, Banka vs) dönsün istiyorsanız TRUEolarak göndermelisiniz
partneridentity	bool	Hayır	Partnerlik kapsamında kayıt edilen kart için Partner hesabının kimlik bilgisi girilmelidir

Servisten dönen parametreler şu şekildedir:

Parametre	Type	Açıklama
Name	string	Kart ekleme sırasında verilen takma ad
CardBin	string	Kart'a ait BIN bilgisi
CardLastFour	string	Kart'ın son 4 hanesi
CardNumber	string	Maskeli kart numarası. Ekranlarında listeletebilirsiniz
Expired	boolean	Kart'ın son kullanma tarihinin geçtiğini/geçmediğini ifade eder. True gelmesi durumunda o kart ile ödeme alınamaz
CardTypeId	int	Kart'ın markasını ifade eder. MasterCard, Visa vs
CardType	string	Kart'ın markasını string olarak döner
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.
InsertDateTimeUtc	DateTime	Kartın eklenme süresine ait tarih bilgisidir. UTC olarak dönmektedir

{
    "ErrorCode": 0,
    "Result": true,
    "Message": "",
    "Body": [
        {
            "Name": "Test Card",
            "CardBin": "453144",
            "CardLastFour": "2283",
            "CardHolderName": "Emir Selim Tütüncü",
            "CardNumber": "453144******2283",
            "Expired": false,
            "CardTypeId": 0,
            "CardType": "Visa",
            "Month": 12,
            "Year": 2025,
            "UniqueCode": "VtsSMsRKBLJMZBApXZrlyTLmKwu6SGYiSFl7/Q2n1d0j5Pon9uA6GQ==",
            "InsertDateTimeUtc": "2026-02-19T22:37:44.397415Z",
            "Details": {
                "CardBankId": 77,
                "CardBank": "AKTİF YATIRIM BANKASI A.Ş.",
                "CardBrandId": 2,
                "CardBrand": "Visa",
                "CardFamilyId": 5,
                "CardFamily": "Paraf",
                "CardKindId": 1,
                "CardKind": "Bireysel Kart",
                "CardTypeId": 1,
                "CardType": "Credit"
            }
        },
        {
            "Name": "EnesIsbank",
            "CardBin": "552879",
            "CardLastFour": "0008",
            "CardHolderName": "Enes Selman Tütüncü",
            "CardNumber": "552879******0008",
            "Expired": false,
            "CardTypeId": 1,
            "CardType": "MasterCard",
            "Month": 9,
            "Year": 2027,
            "UniqueCode": "GG76g2CXnNky6rJEH5UOYYHZZzfONZhWS83O5/Ah5TUmmZ74oF0Ahw==",
            "InsertDateTimeUtc": "2026-02-19T22:37:44.397415Z",
            "Details": {
                "CardBankId": 55,
                "CardBank": "T.HALK BANKASI A.Ş.",
                "CardBrandId": 1,
                "CardBrand": "Master Card",
                "CardFamilyId": 5,
                "CardFamily": "Paraf",
                "CardKindId": 2,
                "CardKind": "Ticari Kart",
                "CardTypeId": 1,
                "CardType": "Credit"
            }
        }
        {
            "Name": "thryhrt",
            "CardBin": "552879",
            "CardLastFour": "0008",
            "CardHolderName": "thryhrt",
            "CardNumber": "552879******0008",
            "Expired": false,
            "CardTypeId": 1,
            "CardType": "MasterCard",
            "Month": 12,
            "Year": 2030,
            "UniqueCode": "bzkBzQ5bH9KOtZ+wgI4RiVxBH2WYF9QeYC94wCqwAn51vC7wrYR4wA==",
            "InsertDateTimeUtc": "2026-02-19T22:37:44.397415Z",
            "Details": {
                "CardBankId": 55,
                "CardBank": "T.HALK BANKASI A.Ş.",
                "CardBrandId": 1,
                "CardBrand": "Master Card",
                "CardFamilyId": 5,
                "CardFamily": "Paraf",
                "CardKindId": 2,
                "CardKind": "Ticari Kart",
                "CardTypeId": 1,
                "CardType": "Credit"
            }
        },
        {
            "Name": "thryhrt",
            "CardBin": "552879",
            "CardLastFour": "0008",
            "CardHolderName": "thryhrt",
            "CardNumber": "552879******0008",
            "Expired": false,
            "CardTypeId": 1,
            "CardType": "MasterCard",
            "Month": 12,
            "Year": 2030,
            "UniqueCode": "IiPYc67bYVYrChRnB4ThSVMERFSw5Vt2PUaBcXeKw9HBTwWqXOSbdQ==",
            "InsertDateTimeUtc": "2026-02-19T22:37:44.397415Z",
            "Details": {
                "CardBankId": 55,
                "CardBank": "T.HALK BANKASI A.Ş.",
                "CardBrandId": 1,
                "CardBrand": "Master Card",
                "CardFamilyId": 5,
                "CardFamily": "Paraf",
                "CardKindId": 2,
                "CardKind": "Ticari Kart",
                "CardTypeId": 1,
                "CardType": "Credit"
            }
        }
    ]
}