Varsayılan Yap

POST/partner/1.0/card/default

Gerekli scope: payment:sale

Kartı, belirtilen kullanım alanının varsayılanı yapar. Aynı kullanım alanında yalnız bir kart varsayılan olabilir; yeni varsayılan öncekinin yerini alır.

Örnek

curl -X POST https://<host>/partner/1.0/card/default \
  -H "X-Api-Key: ..." \
  -H "X-Timestamp: ..." \
  -H "X-Signature: ..." \
  -H "Content-Type: application/json" \
  -d '{
  "id": "8f2c1d5e-9a41-4c7b-b6a2-3f0e8d9c1a2b",
  "usage": "POS_PAYMENT"
}'

İstek Body

Alan	Tip	Açıklama
`id`zorunlu	string	Kayıtlı kart kimliği.
`usage`zorunlu	enum	Hangi kullanım alanı için varsayılan. DEFAULT gönderilemez. `POS_PAYMENTWALLET_TOPUP`

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.

Hatalar

Mesaj anahtarı	HTTP	Neden
`id.empty`	400	id boş gönderildi.
`usage.empty`	400	usage boş ya da DEFAULT gönderildi.

İsteği Dene

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

Mock

id*usage*