vellTRDocs
API Referansına DönMüşterilerVarsayılan Kartı Getir

Varsayılan Kartı Getir

GET/v1/customers/{id}/cards/defaultOptional

Müşterinin varsayılan kayıtlı kartını döndürür. Müşterinin varsayılan kartı yoksa 404 döner.

Kimlik Doğrulama

İmza Deseni

HMAC-SHA256(secretKey, "{timestamp}\nGET\n/v1/customers/{id}/cards/default\n{sha256(\"\")}")
BaşlıkDeğerAçıklama
X-Api-Keypk_live_a1b2c3d4e5f6g7h8Merchant public API key
X-Signature{hmac_sha256_hex}Hex HMAC-SHA256 request signature
X-Timestamp2026-04-13T10:00:00ZISO 8601 UTC request time (±5 min)

Yanıt Parametreleri

AlanTürÖrnek
cardTokenstring"tok_9f8e7d6c5b4a"
customerIdstring"cus_a1b2c3d4e5f6"
last4string"4321"
brandstring"visa"
expMonthinteger12
expYearinteger2028

Yanıt Örneği

JSONYanıt
{
  "cardToken": "tok_9f8e7d6c5b4a",
  "customerId": "cus_a1b2c3d4e5f6",
  "last4": "4321",
  "brand": "visa",
  "expMonth": 12,
  "expYear": 2028
}

Durum Kodları

200Success
201Created
400Bad Request
401Unauthorized
404Not Found
429Rate Limited
DeneSahte
GEThttps://api.pay.sandbox.kvell.group