Kayıtlı Kart Listeleme / Detay Getirme

• Endpoint: /vendor/creditcard
• HTTP Method: GET
• Request Content-Type: application/json
• Response Content-Type: application/json
• Yetkilendirme: Geçerli AccessToken zorunludur.
  (Bkz: 2. Kimlik Doğrulama – AccessToken Alınması)

Açıklama

Bu servis aracılığıyla üyeye ait kayıtlı kredi kartı bilgileri listelenebilir. İsteğe bağlı olarak belirli bir CardId parametresi ile tek bir kartın detayı da getirilebilir.

Not: CardId parametresi gönderilmezse sistem, üyeye ait tüm kayıtlı kartları sayfalandırmalı olarak döndürür.

Bu endpoint yalnızca okuma işlemi (GET) içindir — kayıt ekleme, silme veya güncelleme yapılmaz.

Header Bilgileri

Header Adı	Zorunlu	Açıklama
Authorization	Evet	Bearer {AccessToken} formatında geçerli token
Content-Type	Evet	application/json

Route Parametreleri - Tek Kayıt Getirme

Parametre	Tip	Zorunlu	Açıklama
CardId	string	Hayır	Belirtilirse yalnızca ilgili kartın bilgisi döner.

Query Parametreleri – Sayfalandırma (Listeleme)

Parametre	Tip	Zorunlu	Açıklama
page	integer	Hayır	Getirilecek sayfa numarası (varsayılan: 1).
pageSize	integer	Hayır	Sayfa başına kayıt sayısı (varsayılan: 10, maksimum: 100).

Örnek Request

Listeleme

GET /vendor/creditcard?page=1&pageSize=10

Tek Kart Detayı

GET /vendor/creditcards/{CardId}

Başarılı Response

{  
    "CardId": "9s84fsd4f8sd4f4s6df4sdf84sd",  
    "name": "Test Akbank Kartım",  
    "CardNumber": "858563******9966",  
    "DealerOrCustomerName": "Test Ana Bayi",  
    "InsertedDate": "15.08.2025",  
    "Status": "Aktif",  
    "Bank": "Akbank"  
}

Listeleme Senaryosunda (Sayfalı Dönüş)

{  
    "data": [  
        {  
            "cardId": "56767939-3f1d-4d40-9873-084215028412",  
            "name": "Burak Kılıçarslan",  
            "cardNumber": "404308******9028",  
            "dealerOrCustomerName": null,  
            "insertedDate": "2025-08-04T10:03:54.848863",  
            "success": true,  
            "bank": "Garanti Bankası"  
        },  
        {  
            "cardId": "8eebfde2-8a77-4198-a998-3bc5f8069bf4",  
            "name": "Sadık TEST",  
            "cardNumber": "435508******4358",  
            "dealerOrCustomerName": null,  
            "insertedDate": "2024-07-11T11:33:27.4334707",  
            "success": true,  
            "bank": "Akbank"  
        },  
        {  
            "cardId": "624b1eaa-69cd-4a99-9408-54dc34fb888b",  
            "name": "testttt",  
            "cardNumber": "403360******0327",  
            "dealerOrCustomerName": null,  
            "insertedDate": "2024-12-25T11:35:54.7623235",  
            "success": true,  
            "bank": "Kuveyt Türk Katılım Bankası"  
        }  
    ],  
    "currentPage": 1,  
    "rowCount": 7,  
    "pageCount": 1  
}

Notlar & En İyi Uygulamalar

• Kart numarası, güvenlik nedeniyle maskelenmiş biçimde döner (yalnızca ilk 6 ve son 4 hane görünür).
• Status alanı kartın kullanım durumunu belirtir: "Aktif" veya "Pasif".
• InsertedDate değeri "dd.MM.yyyy" formatındadır.
• totalCount, page ve pageSize bilgileri sayfalandırmalı yanıtların tamamında yer alır.
• Listeleme yapıldığında, yalnızca ilgili üyeye ait kart kayıtları döner.
• Token süresi dolmuşsa istek 401 Unauthorized döner; yeni token alınarak tekrar gönderilmelidir.