Sipariş Kalemi Tamamla (Fulfill)

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

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

Yetkilendirme

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

Path parametreleri

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

Kalemin bu siparişe ve size ait olması gerekir; değilse yanıt 404 Not Found olur (403 değil — resource existence leak'i önlemek için).

İstek gövdesi

{
  "codes": ["XYZ1-2345-ABCD", "WXYZ-9876-LMNO"]
}

Alan	Tip	Zorunlu	Açıklama
`codes`	string[]	evet	Müşteriye teslim edilecek kodlar; adedi kalemin `quantity` değeriyle birebir aynı olmalı

Kalem tek seferde teslim edilir; kısmi teslimat yoktur.

Yanıt

200 OK

{
  "orderId": "019e4454d2477dcc953c4da08e1cecc7",
  "orderItemId": "019e4454d2aa795db056dcbf0e102e54",
  "fulfilledCount": 2
}

Alan	Tip	Açıklama
`orderId`	string	İşlemin uygulandığı sipariş
`orderItemId`	string	Teslim edilen kalem
`fulfilledCount`	number	Kaydedilen kod adedi

Ön kontroller

Kalemin size ve bu siparişe ait olduğu doğrulanır (uyumsuzsa 404)
Kalem WaitingForSupply durumunda olmalıdır — yalnızca tedarik beklenen kalem teslim edilebilir. Diğer durumlarda (Cancelled, Completed, Refunded, Reserved, Pending) yanıt 422 olur ve detail kalemin o anki durumunu söyler
Kod sayısı quantity ile birebir aynı olmalıdır

Rezerve edilmiş kalemler

Bir kalem satın alma sırasında stoktan rezerve edilmiş olabilir. Bu durumda kodlar rezervasyonu da kapatacak şekilde işlenir; istek ve yanıt sizin açınızdan değişmez. Rezervasyon iptal edilmiş ya da çoktan tamamlanmışsa yanıt 422 olur ve detail rezervasyonun o anki durumunu söyler.

Hata kodları

Code	Anlam
`400`	Kod listesi eksik veya boş
`401`	HMAC kimlik doğrulama hatası
`403`	Gerekli scope eksik
`404`	Sipariş/kalem yok ya da size ait değil
`422`	Kalem tedarik beklemiyor, kod sayısı `quantity` ile uyumsuz ya da rezervasyon uygun durumda değil
`429`	Hız limiti aşıldı

Network kesintisi sonrası

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