İade Taleplerini Listele

Müşterilerin kalemleriniz için açtığı iade/şikâyet taleplerini listeler.

GET/v1/claimsscope:RefundsRead

Yetkilendirme

Bu endpoint RefundsRead scope'u gerektirir. Bkz. İzinler.

Query parametreleri

Sayfalama zorunlu — page, pageSize, orderBy, order alanları gerekir. Detay için Sayfalama sayfasına bakın.

Parametre	Tip	Açıklama
`status`	string	`Open`, `WaitingSeller`, `WaitingBuyer`, `Resolved`, `Cancelled`
`orderId`	string(32)	Tek bir siparişin talepleri
`fromDate`	date	Başlangıç tarihi (dahil)
`toDate`	date	Bitiş tarihi (dahil)

orderBy şu alanlardan biri olabilir: CreatedAt, UpdatedAt.

Yanıt formatı

200 OK ile birlikte pagination header'ları (X-Total-Count, X-Page, X-Page-Size, X-Next-Page, X-Prev-Page) döner. Body sadece kayıt dizisini içerir.

[
  {
    "id": "019ebc0c1c27731a95b3b308e1c9cab5",
    "orderId": "019ebbce761e76f5b57e8e78d4632e25",
    "orderNumber": "ORD-20260612-OFX40K",
    "orderItemId": "019ebbce76257cdf9453de6787aa4e7d",
    "reason": "WrongProduct",
    "description": "Aldığım kod farklı bir ürüne ait.",
    "status": "WaitingBuyer",
    "createdAt": "2026-06-12T13:36:10.791513+00:00",
    "updatedAt": "2026-06-12T13:36:58.485924+00:00"
  }
]

Alanlar

Alan	Tip	Açıklama
`id`	string	Talep kimliği
`orderId` / `orderNumber`	string	Talebin açıldığı sipariş
`orderItemId`	string	Talebe konu kalem
`reason`	string	`InvalidCode`, `WrongProduct`, `ExpiredCode`, `Other`
`description`	string	Müşterinin açıklaması
`status`	string	Talebin durumu; `WaitingSeller` sizin aksiyonunuzu bekler
`createdAt`	datetime	ISO 8601, UTC
`updatedAt`	datetime	Son hareket; çözülen taleplerde çözüm anını gösterir

Hata kodları

Code	Anlam
`400`	Sayfalama, `status` ya da tarih aralığı geçersiz
`401`	HMAC kimlik doğrulama hatası
`403`	Gerekli scope eksik
`429`	Hız limiti aşıldı