Kartları Listele

POST/partner/1.0/card/list

Gerekli scope: payment:inquiry

Kayıtlı kartları listeler. Yanıtta kart numarası maskeli döner; tam PAN hiçbir uçtan verilmez.

Yanıt sayfalama zarfı değil, düz dizidir — her eleman Kart Kaydet yanıtıyla aynı alanları taşır.

Örnek

curl -X POST https://<host>/partner/1.0/card/list \
  -H "X-Api-Key: ..." \
  -H "X-Timestamp: ..." \
  -H "X-Signature: ..." \
  -H "Content-Type: application/json" \
  -d '{
  "usage": "POS_PAYMENT",
  "status": "ACTIVE"
}'

İstek Body

Alan	Tip	Açıklama
`usage`	enum	Kullanım alanı filtresi. Boş bırakılırsa DEFAULT = hepsi. Varsayılan: `DEFAULT` `POS_PAYMENTWALLET_TOPUPBOTH`
`status`	enum	Durum filtresi. Boş bırakılırsa DEFAULT = hepsi. Varsayılan: `DEFAULT` `ACTIVEEXPIREDREVOKEDSUSPENDED`
`customerId`	string	Bu müşteri adına sakladığınız kartlar. Boş ise işletmenizin kendi kartları listelenir.

Yanıt

Alan	Anlamı
`id`	Kayıtlı kart kimliği. Ödemede `savedCardId`, plan kurmada `savedCardId` olarak bu değeri gönderirsiniz.
`maskedPan`	Maskeli kart numarası. Tam PAN hiçbir uçtan dönmez.
`alias`	Kart için verdiğiniz hatırlatıcı isim.
`cardHolderName`	Kart üzerindeki ad-soyad.
`brand` / `bankName` / `cardType`	Kart markası, bankası ve tipi.
`expiryMonth` / `expiryYear`	Son kullanma ayı (AA) ve yılı (YYYY).
`usage`	Kartın kullanım alanı (`POS_PAYMENT`, `WALLET_TOPUP`, `BOTH`).
`status`	Kart durumu (`ACTIVE`, `EXPIRED`, `REVOKED`, `SUSPENDED`).
`isDefault`	Bu kullanım alanında varsayılan kart mı.
`customerId`	Kart bir müşteri adına saklandıysa o müşterinin kimliği; işletmenizin kendi kartında boş.
`createdDate`	Kaydın oluşturulma tarihi.

Örnek yanıt (content)

[
  {
    "id": "8f2c1d5e-9a41-4c7b-b6a2-3f0e8d9c1a2b",
    "alias": "Şirket kartı",
    "maskedPan": "512754******3332",
    "brand": "MASTERCARD",
    "usage": "POS_PAYMENT",
    "status": "ACTIVE",
    "isDefault": true
  }
]

İsteği Dene

Önizleme modu — değerler kod örneklerini günceller, gerçek istek atılmaz.

Mock

usagestatuscustomerId