Siparişleri Listele

Kaleminizin bulunduğu siparişleri listeler.

GET/v1/ordersscope:OrdersRead

Yetkilendirme

Bu endpoint OrdersRead 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	`Processing`, `Completed`, `Cancelled`, `Refunded`
`orderNumber`	string	Sipariş numarası ile arama
`fromDate`	date	Başlangıç tarihi (dahil)
`toDate`	date	Bitiş tarihi (dahil)

orderBy yalnızca CreatedAt olabilir.

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": "019f03a64c2777f49999aa2ce39834d9",
    "orderNumber": "ORD-20260626-FOYE3S",
    "status": "Processing",
    "paymentMethod": "CreditCard",
    "currency": "TRY",
    "grandTotal": 455.0,
    "totalItemCount": 1,
    "createdAt": "2026-06-26T11:17:37.97438+00:00",
    "paidAt": "2026-06-26T11:17:49.664373+00:00",
    "completedAt": null,
    "cancelledAt": null
  }
]

Alanlar

Alan	Tip	Açıklama
`id`	string	Sipariş kimliği
`orderNumber`	string	Müşteriye gösterilen sipariş numarası
`status`	string	Siparişin sizin açınızdan durumu; aşağıdaki nota bakın
`paymentMethod`	string	`CreditCard` ya da `Wallet`; ödeme alınmadıysa boştur
`currency`	string	Sipariş para birimi
`grandTotal`	decimal	Yalnızca sizin kalemlerinizin toplamı
`totalItemCount`	number	Yalnızca sizin kalemlerinizin adedi
`createdAt`	datetime	ISO 8601, UTC
`paidAt`	datetime	Ödemenin alındığı an
`completedAt`	datetime	Siparişin tamamlandığı an
`cancelledAt`	datetime	Siparişin iptal edildiği an

Durum ve tutarlar size göredir

Bir sipariş birden fazla satıcıdan kalem içerebilir. Bu uçtaki grandTotal ve totalItemCount yalnızca sizin kalemlerinizi kapsar; başka satıcıların malları bu toplamlara girmez.

status de aynı şekilde sizin kalemlerinizden türetilir:

Değer	Anlamı
`Processing`	En az bir kaleminiz hâlâ iş bekliyor (kod yükleme, iade talebi vb.)
`Completed`	Kalemlerinizin tamamı sonuçlandı ve en az biri teslim edildi
`Cancelled`	Sipariş iptal edildi ya da kalemlerinizin tamamı iptal edildi
`Refunded`	Sipariş iade edildi

Ödeme tamamlanmamış siparişler (müşteri sepeti onaylamış ama ödeme geçmemiş) bu listeye hiç girmez; sizin için henüz bir iş yoktur.

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ı