T-SOFT/Storefront API/Sadakat Hareketleri

Sadakat Hareketleri

Oturum açmış müşterinin sadakat puanı hareketlerini (puan defteri) listeler. Her kayıt bir kazanım veya harcama satırıdır. Kaynak salt-okunurdur ve kimliği doğrulanmış müşteri token'ı gerektirir.

Yetki:storefront:account — müşteri token'ı zorunlu.

Listeleme

GET /loyalty-transactions

curl -s 'https://<domain>/api/v3/storefront/account/2026-01/loyalty-transactions' \
  -H 'Accept: application/vnd.api+json' \
  -H 'Authorization: Bearer <TOKEN>'

Örnek bir kayıt:

{
  "type": "loyalty-transactions",
  "id": "4821",
  "attributes": {
    "description": "Sipariş puanı kazanımı",
    "receivable": 150,
    "debt": 0,
    "orderId": 90233,
    "type": "earn",
    "remaining": 150,
    "createdAt": 1767882130,
    "expiresAt": 1783606930
  }
}

Alanlar

Alan	Açıklama
`description`	Hareket açıklaması
`receivable`	Kazanılan (alacak) puan
`debt`	Harcanan (borç) puan
`orderId`	İlişkili sipariş id'si (varsa)
`type`	Hareket türü
`remaining`	Bu hareketten kalan kullanılabilir puan
`createdAt`	Hareket tarihi — Unix zaman damgası (saniye)
`expiresAt`	Puanın son geçerlilik tarihi — Unix zaman damgası (saniye), yoksa `null`

Sıralama

Sort	Anlamı
`createdAt`	Hareket tarihine göre

Varsayılan sıralama -createdAt (en yeni önce).

Bu kaynak salt-okunurdur; yeni puan hareketi oluşturulamaz. Bakiye, satırların receivable/debt toplamından değil, aktif satırların remaining değerinden okunmalıdır — süresi dolan puanlar remaining üzerinden düşer.