2. 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/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

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

boolean

Hayır

Kartın detay bilgileri (Bin, Tip, Marka, Banka vs) dönsün istiyorsanız TRUEolarak göndermelisiniz

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

Identity

string

Kart sahibinin kimlik numarası veya vergi kimlik numarası

Expired

boolean

Kart'ın son kullanma tarihinin geçtiğini/geçmediğini ifade eder. True gelmesi durumunda o kart ile ödeme alınamaz

Scope

int

Kart'ın hangi alanda kullanılacağını gösteren parametredir

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.

"ErrorCode": 0,
    "Result": true,
    "Message": "",
    "Body": [
        {
            "Scope": 2,
            "Name": "test kartı",
            "Identity": "",
            "CardBin": "45467121",
            "CardLastFour": "7894",
            "CardHolderName": "Test Kartı",
            "Expired": false,
            "CardTypeId": 1,
            "CardType": "Credit",
            "Month": 12,
            "Year": 2025,
            "UniqueCode": "30H4WW7Es/HHB7l8PFvl+XnMQs1h0d2/cX7E5H9LgzOw1Ef0E7whSQ==",
            "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"
            }
        },
        {
            "Scope": 2,
            "Name": "test kartı",
            "Identity": "273******602",
            "CardBin": "43550930",
            "CardLastFour": "7894",
            "CardHolderName": "Test Kartı",
            "Expired": false,
            "CardTypeId": 1,
            "CardType": "Credit",
            "Month": 12,
            "Year": 2025,
            "UniqueCode": "EzqrWIPvZAewotdQ48DRsrnu/WBfOwvOctM11rOaeEMvYDqGZzpPxA==",
            "Details": {
                "CardBankId": 58,
                "CardBank": "AKBANK T.A.Ş.",
                "CardBrandId": 2,
                "CardBrand": "Visa",
                "CardFamilyId": 4,
                "CardFamily": "Axess",
                "CardKindId": 1,
                "CardKind": "Bireysel Kart",
                "CardTypeId": 1,
                "CardType": "Credit"
            }
        }

Last updated