Sipariş Kalemi Tamamla (Fulfill)

Dijital ürün için müşteriye teslim edilecek kodları yükler ve order item'ı Completed duruma alır.

POST/v1/orders/{orderId}/items/{itemId}/fulfillmentsscope:OrdersWrite

Path parametreleri

Parametre	Açıklama
`orderId`	Hedef sipariş ID'si
`itemId`	Tamamlanacak kalemin ID'si

{
  "codes": ["XYZ1-2345-ABCD", "WXYZ-9876-LMNO"],
  "note": "Steam wallet kodları teslim edildi"
}

Alan	Tip	Zorunlu	Açıklama
`codes`	string[]	evet	Müşteriye teslim edilecek kodlar. Quantity ile uyumlu olmalı
`note`	string	opsiyonel	İç not, audit log'a yansır

201 Created

{
  "id": "01H8N3P4Q5R6...",
  "orderId": "01H8M2K6X7P9...",
  "orderItemId": "01H8M2L1M2N3...",
  "createdAt": "2026-05-13T13:45:22.000Z"
}

İstek işlenmeden önce sunucu şu doğrulamaları yapar:

Sipariş + kalemin satıcıya ait olduğu doğrulanır (uyumsuzsa 404)
Kalem Processing durumunda olmalıdır (Completed/Cancelled ise 409 Conflict)
Kod sayısı quantity ile birebir aynı olmalıdır

Code	Anlam
`400`	Kod listesi eksik veya boş
`403`	`OrdersWrite` scope eksik
`404`	Sipariş/kalem yok ya da size ait değil
`409`	Kalem zaten fulfilled/cancelled
`422`	Kod sayısı quantity ile uyumsuz

Network kesintisi sonrası

Idempotency-Key kullanarak retry yapın — aynı kodlar iki kez teslim edilmez.