orderCancel argümanları
| Argüman | Zorunlu | Açıklama |
|---|---|---|
| orderId | Evet | İptal edilecek sipariş |
| reason | Evet | İptal nedeni: müşteri isteği, ödeme reddi, dolandırıcılık, stok, personel hatası ya da diğer |
| restock | Evet | Siparişe ayrılan stok geri eklensin mi |
| refundMethod | Hayır | Ödeme yöntemine iade ya da mağaza kredisi |
| notifyCustomer | Hayır | Müşteriye bildirim gönderilsin mi |
| staffNote | Hayır | Müşterinin görmediği iç not |
Ödeme yalnız onaylanmış ama tahsil edilmemişse, iade seçilmese bile bu onay iptalle birlikte serbest bırakılır.
Ne zaman iptal edilebilir?
- Sipariş daha önce iptal edilmemiş olmalı.
- Bekleyen ödeme onayı olmamalı.
- Süren bir iade (return) süreci olmamalı.
- İptal edilemeyen açık gönderimleri olmamalı.
Sipariş, sonradan pasife alınan bir lokasyona atanmışsa davranış ödeme durumuna bağlıdır. Ödenmiş siparişte restock açıksa iptal hata verir, çünkü stok pasif lokasyona geri eklenemez. Ödenmemiş siparişte iptal başarılı olur ama stok hiçbir yere geri eklenmez.
İade: refundCreate
refundCreate, siparişe para iadesi oluşturur ve şu senaryoları destekler:
| Senaryo | Not |
|---|---|
| Kalem iadesi | İsteğe bağlı stoğa geri ekleme ile |
| Kargo bedeli iadesi | Ayrı tutar |
| Gümrük vergisi ve ek ücret iadesi | Ayrı alanlar |
| Mağaza kredisi olarak iade | Etkinse |
| Kısmi ve tam iade | İkisi de desteklenir |
Oluşan iade siparişin refunds alanından izlenir. Belgeye göre refundCreate ile returnRefund benzer çalışır; fark, refundCreate’in kalemler için stoğa geri ekleme davranışını belirlemenize izin vermesidir.
Webhook’lar ve stok
| Olay | Webhook konusu |
|---|---|
| Sipariş iptal edildi | orders/cancelled |
| İade oluşturuldu | refunds/create |
| Müşteri iade talep etti | returns/request |
| Sipariş güncellendi | orders/updated |
Para iadesi her zaman ürünün depoya döndüğü anlamına gelmez. Stoğa geri eklemeyi ürün fiziksel olarak geldiğinde yapmak, olmayan ürünün pazaryerinde yeniden satılmasını önler.
Sık hatalar
| Belirti | Neden | Çözüm |
|---|---|---|
| İptal reddedildi | Sipariş zaten iptal, bekleyen ödeme onayı ya da süren iade var | Koşulları kontrol edin, önce iadeyi kapatın |
| İptal hata verdi, ödenmiş sipariş | Sipariş pasif lokasyona atanmış ve restock açık | restock false ile iptal edin, stoğu elle düzeltin |
| İade sonrası stok iki kez arttı | Hem iadede hem elle stok eklendi | Stoğa geri eklemeyi tek yerden yapın |
| 403 | write_orders kapsamı yok | Kapsamı ekleyin |
İptal geri alınamaz. Toplu iptal betikleri çalıştırmadan önce sipariş listesini bir kez daha kontrol edin.
Sık sorulanlar
Shopify’da sipariş API ile nasıl iptal edilir?
GraphQL’deki orderCancel mutasyonuyla. orderId, reason ve restock zorunludur; işlem geri alınamaz.
İptal edilen siparişin stoğu geri gelir mi?
restock argümanını true gönderirseniz siparişe ayrılan stok geri eklenir. Pasif lokasyona atanmış siparişlerde istisnalar vardır.
Shopify’da iade API ile nasıl yapılır?
refundCreate mutasyonuyla. Kalem, kargo ve ek ücret iadeleri ile stoğa geri ekleme davranışı bu mutasyonda belirlenir.
refundCreate ile returnRefund farkı nedir?
İkisi de para iadesi yapar. refundCreate kalemlerin stoğa geri eklenmesini de yönetir; returnRefund yalnız finansal iadeye odaklanır.
Kaynaklar
İlgili Shopify API konuları
Son güncelleme: 27.10.2026 · Shopify API rehberinin tamamı