T-SOFT/Storefront API/Ödeme Seçenekleri

Ödeme Seçenekleri

Bir ürün için geçerli ödeme yöntemlerini ve kredi kartı taksit tablosunu döndürür. Ürün detay sayfasındaki "taksit seçenekleri" bölümünü beslemek için tasarlanmıştır. Salt-okunur bir kaynaktır ve yalnızca listeleme destekler.

Yetki:storefront:read — herkese açık, token isteğe bağlı.

filter[productId]zorunludur — filtresiz veya geçersiz (pozitif tam sayı olmayan) değerle çağrı 400 döner. sort ve page parametreleri bu kaynakta desteklenmez.

Listeleme

GET /payment-options

curl -s 'https://<domain>/api/v3/storefront/2026-01/payment-options?filter[productId]=42' \
  -H 'Accept: application/vnd.api+json' \
  -H 'Authorization: Bearer <TOKEN>'

Yanıt, id'si sorgulanan ürünün id'si olan tek kayıtlık bir liste döner:

{
  "type": "payment-options",
  "id": "42",
  "attributes": {
    "productId": 42,
    "basePrice": 199.9,
    "currencyCode": "TRY",
    "paymentMethods": [
      { "title": "Havale / EFT", "price": 189.91 },
      { "title": "Kapıda Ödeme", "price": 209.9 }
    ],
    "creditCards": [
      { "bankId": 5, "cardId": 3, "cardName": "Bonus", "colorCode": "#7ab928", "imageUrl": "https://<domain>/Data/KrediKartLogo/3.jpg", "installments": [
        { "count": 1, "extraCount": 0, "amount": 199.9, "total": 199.9, "posId": 2, "commission": 0 },
        { "count": 3, "extraCount": 0, "amount": 68.63, "total": 205.9, "posId": 2, "commission": 3 },
        { "count": 6, "extraCount": 1, "amount": 30.27, "total": 211.9, "posId": 2, "commission": 6 }
      ] }
    ]
  }
}

Alanlar

Alan	Açıklama
`productId`	Sorgulanan ürünün id'si
`basePrice`	Hesaba esas ürün fiyatı — müşteri grubuna özel fiyat, KDV gösterimi ve para birimi çevrimi uygulanmış hali
`currencyCode`	Fiyatların para birimi
`paymentMethods`	Kart dışı ödeme yöntemleri; her satır `title` (yöntem adı) ve `price` (yöntem farkı uygulanmış toplam)
`creditCards`	Taksit tanımı olan kart programları; taksit tanımı olmayan kartlar listeye girmez

creditCards satırındaki alanlar:

Alan	Açıklama
`bankId` / `cardId`	Banka ve kart programı id'si
`cardName`	Kart programı adı (ör. Bonus, World)
`colorCode`	Kart programının renk kodu — taksit tablosunu renklendirmek için
`imageUrl`	Kart logosu tam URL
`installments`	Taksit satırları (aşağıda)

installments satırındaki alanlar:

Alan	Açıklama
`count`	Taksit sayısı (`1` = tek çekim)
`extraCount`	Kampanya gereği eklenen artı taksit sayısı
`amount`	Taksit başına tutar
`total`	Vade farkı uygulanmış toplam tutar
`posId`	Ödemenin geçeceği sanal pos id'si
`commission`	Uygulanan vade farkı oranı (yüzde)

Taksit satırları ürün fiyatının alt/üst limit koşullarını sağlayan tanımlardan oluşur; ürüne özel taksit kuralı tanımlıysa o kural geçerlidir (kapalıysa satır hiç dönmez).
Yalnız ürün sayfalarında gösterilmek üzere işaretlenmiş taksit tanımları döner. Mağaza bir taksidi ürün sayfasından gizlemişse o satır bu kaynakta yer almaz; ödeme adımında görünmeye devam edebilir.
paymentMethods satırları yöntemin alt ve üst tutar sınırını sağlar. Üst sınır 0 ise sınırsızdır.
Fiyat alanları bu kaynakta düz sayıdır; Money objesi kullanılmaz. Görüntülerken currencyCode ile birlikte formatlayın.

Filtreler

Filtre	Örnek	Davranış
`filter[productId]`	`filter[productId]=42`	Zorunlu. Taksit tablosu hesaplanacak ürün