Sipariş Detayı

Bir siparişi ve o siparişteki kendi kalemlerinizi döner.

GET/v1/orders/{id}scope:OrdersRead

Yetkilendirme

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

Path parametresi

Siparişte kaleminiz yoksa yanıt 404 Not Found olur (403 değil — resource existence leak'i önlemek için). Başka satıcıların kalemleri yanıtta hiç görünmez.

Yanıt

{
  "id": "019f03aedfa47de7bee62f123f836578",
  "orderNumber": "ORD-20260626-4UDXDZ",
  "status": "Cancelled",
  "paymentMethod": "Wallet",
  "currency": "TRY",
  "subTotal": 34.0,
  "discountTotal": 0.0,
  "grandTotal": 34.0,
  "totalItemCount": 1,
  "buyerInvoiceInfo": {
    "invoiceType": "Individual",
    "firstName": "Mustafa",
    "lastName": "Demir",
    "companyName": null,
    "taxIdentityNumber": null,
    "taxOffice": null,
    "eInvoice": false,
    "cityName": "Amasya",
    "districtName": "Gümüşhacıköy",
    "neighborhood": "Test",
    "addressLine": "Test Mah. No 1"
  },
  "items": [
    {
      "id": "019f03aee03376478ef3dced6bda6632",
      "offerId": "019df287efd8701987c25a39d856fbcc",
      "variantId": "019df28591ba77009e8e5ec5bd4b371c",
      "productName": "Pasha Fencer 60 Elmas",
      "variantName": null,
      "quantity": 1,
      "unitPrice": 34.0,
      "lineTotal": 34.0,
      "currency": "TRY",
      "status": "Cancelled",
      "deliveredAt": null,
      "digitalCodes": []
    }
  ],
  "createdAt": "2026-06-26T11:27:00.145256+00:00",
  "paidAt": null,
  "completedAt": null,
  "cancelledAt": "2026-06-26T11:59:08.401118+00:00"
}

Sipariş alanları

Liste ucuyla aynı; bkz. Siparişleri Listele. Ek olarak şunlar döner:

Alan	Tip	Açıklama
`subTotal`	decimal	Kalemlerinizin indirim öncesi toplamı
`discountTotal`	decimal	Kalemlerinize düşen indirim
`buyerInvoiceInfo`	object	Alıcının fatura bilgileri; adres kaydı yoksa boştur
`items`	array	Bu siparişteki sizin kalemleriniz

subTotal, discountTotal ve grandTotal yalnızca sizin kalemlerinizi kapsar: grandTotal = subTotal − discountTotal.

`buyerInvoiceInfo`

Faturayı düzenleyebilmeniz için alıcının fatura bilgileri. Alıcının telefon numarası paylaşılmaz.

Alan	Tip	Açıklama
`invoiceType`	string	`Individual` ya da `Corporate`
`firstName` / `lastName`	string	Bireysel faturada alıcı adı
`companyName`	string	Kurumsal faturada firma adı
`taxIdentityNumber`	string	Vergi/TC kimlik numarası
`taxOffice`	string	Vergi dairesi
`eInvoice`	boolean	Alıcı e-fatura mükellefi mi
`cityName` / `districtName`	string	İl / ilçe
`neighborhood`	string	Mahalle
`addressLine`	string	Açık adres

`items[]`

Alan	Tip	Açıklama
`id`	string	Kalem kimliği — teslim ve iptal uçlarında kullanılır
`offerId`	string	Kalemin satıldığı teklif
`variantId`	string	Ürün varyantı
`productName`	string	Ürün adı
`variantName`	string	Varyant adı; her kalemde bulunmayabilir
`quantity`	number	Adet
`unitPrice`	decimal	Birim fiyat
`lineTotal`	decimal	Kalemin toplamı
`currency`	string	Para birimi
`status`	string	`Pending`, `Reserved`, `Completed`, `Cancelled`, `RefundRequested`, `Refunded`, `WaitingForSupply`
`deliveredAt`	datetime	Kalemin teslim edildiği an, ISO 8601, UTC
`digitalCodes`	array	Kaleme teslim edilmiş kodlar; henüz teslim yoksa boş dizi

`items[].digitalCodes[]`

Alan	Tip	Açıklama
`id`	string	Kod kaydının kimliği
`maskedValue`	string	Kodun maskelenmiş hâli (`ABC****XYZ`); açık değer hiçbir uçta dönmez
`deliveredAt`	datetime	Kodun müşteriye iletildiği an

Tutarlar size göredir

Bir sipariş birden fazla satıcıdan kalem içerebilir; bu uçtaki tutarlar ve items dizisi yalnızca sizin kalemlerinizi kapsar. Komisyon ve hakediş tutarları için Finansal Hareketler ucunu kullanın.

Hata kodları

Code	Anlam
`401`	HMAC kimlik doğrulama hatası
`403`	Gerekli scope eksik
`404`	Sipariş bulunamadı ya da bu siparişte kaleminiz yok
`429`	Hız limiti aşıldı