T-SOFT/Storefront API/Kuponlar

Kuponlar

coupons kaynağı, oturum açmış müşteriye tanımlı indirim kuponlarını listeler. Salt-okunurdur ve yalnızca index destekler. Kimliği doğrulanmış müşteri token'ı gerektirir.

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

Listeleme

GET coupons

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

Örnek bir kupon kaydı:

{
  "type": "coupons",
  "id": "312",
  "attributes": {
    "code": "HOSGELDIN50",
    "description": "İlk siparişe özel 50 TL indirim",
    "discountType": "amount",
    "discountValue": 50,
    "discountAmount": { "amount": "50.00", "currencyCode": "TRY", "decimalPlaces": 2 },
    "minLimit": { "amount": "500.00", "currencyCode": "TRY", "decimalPlaces": 2 },
    "usageCount": 0,
    "maxUsageCount": 1,
    "startDate": 1719792000,
    "finishDate": 1722470400,
    "lastUsageDate": 0,
    "isTimeOver": false,
    "isUsed": false,
    "applicationArea": "cart"
  }
}

Alanlar

Bu kaynaktaki tüm alanlar salt-okunurdur.

Alan	Açıklama
`code`	Kupon kodu
`description`	Açıklama
`discountType`	İndirim türü
`discountValue`	İndirim değeri (sayısal)
`discountAmount`	İndirim tutarı — Money nesnesi
`minLimit`	Kuponun geçerli olması için gereken alt sepet limiti — Money nesnesi
`usageCount`	Kuponun kullanım sayısı
`maxUsageCount`	En çok kullanım sayısı
`startDate`	Başlangıç tarihi (unix)
`finishDate`	Bitiş tarihi (unix)
`lastUsageDate`	Son kullanım tarihi (unix); kullanılmadıysa `0`
`isTimeOver`	Süresi doldu mu?
`isUsed`	Kullanıldı mı?
`applicationArea`	Kuponun uygulanabildiği alan

discountAmount ve minLimit birer Money nesnesidir: { "amount": "...", "currencyCode": "TRY", "decimalPlaces": 2 }. discountValue ise ham sayısal değerdir; kullanıcıya gösterirken tutar için discountAmount nesnesini tercih et.

Sıralama

Varsayılan sıralama startDate alanına göre azalan yöndedir (-startDate); en yeni kuponlar başta gelir.

Sort	Anlamı
`startDate`	Kuponun başlangıç tarihi (varsayılan: azalan)

Bir kuponun kullanılabilir olması için isTimeOver ve isUsed alanlarının ikisinin de false olması gerekir. Yalnızca tarihe bakma; isUsed bayrağını da kontrol et.