Durumlar ve anlamları
| API değeri | Panelde | Anlamı | Stok |
|---|---|---|---|
| pending | Ödeme bekleniyor | Sipariş alındı, ödeme yok | Stok tut açıksa bekletilir |
| processing | Hazırlanıyor | Ödeme alındı, gönderim bekliyor | Düşüldü |
| on-hold | Beklemede | Ödeme onayı bekleniyor | Düşüldü |
| completed | Tamamlandı | Sipariş tamamlandı | Değişmez |
| cancelled | İptal edildi | Yönetici ya da müşteri iptal etti | Stok yönetimi açıksa geri eklenir |
| refunded | İade edildi | Tutarın tamamı iade edildi | İadede seçilirse geri eklenir |
| failed | Başarısız | Ödeme başarısız ya da reddedildi | Düşülmüşse geri eklenir |
| trash | Çöp | Sipariş çöp kutusunda | - |
Tüm ürünleri sanal ve indirilebilir olan siparişler dışında her sipariş hazırlanma aşamasından geçer. Mağaza sahibi ürünü kargoladıktan sonra durumu elle Tamamlandı yapar.
Durumu API ile değiştirmek
- Tamamlandı yapmak: PUT /orders/ID ve gövde: status completed
- İptal etmek: PUT /orders/ID ve gövde: status cancelled
- Toplu: POST /orders/batch ve update listesinde id ile status
Sipariş oluştururken set_paid=true gönderirseniz belgeye göre sipariş processing olur ve stok düşer. Bu alan yalnız yazılır, okunmaz.
Önemli: WooCommerce’in iade belgesine göre durumu doğrudan Cancelled ya da Refunded yapmak müşteriye para iadesi yapmaz. Parayı iade etmek için iade uç noktasını ya da paneldeki iade düğmesini kullanın: iade ve iptal.
Taslak siparişler ve özel durumlar
Blok tabanlı ödeme sayfası, müşteri “Siparişi ver” düğmesine bastığında geçici bir taslak sipariş oluşturur. Taslaklar Siparişler ekranında ayrı sekmede görünür ve WooCommerce her gün etkin olmayan taslakları kendiliğinden siler. Senkron yazılımları bu kayıtları gerçek sipariş saymamalıdır.
İade talebi, kargoda ya da benzeri adlarla eklentilerin eklediği özel durumlar da status alanında görünebilir. Entegrasyonunuz tanımadığı bir durumla karşılaşınca siparişi atlamak yerine kayda geçirip kullanıcıya göstermelidir.
Durum değişikliğini izlemek
Durum değişikliklerini iki yolla yakalarsınız: düzenli okuma ve webhook.
| Yöntem | Nasıl | Artısı | Eksisi |
|---|---|---|---|
| Düzenli okuma | GET /orders ve modified_after | Kaçırma riski düşük | Gecikme okuma aralığı kadar |
| Webhook | order.updated konusu | Anında bildirim | Webhook devre dışı kalabilir |
| İkisi birlikte | Webhook ve aralıklı okuma | Hızlı ve güvenli | Kurulumu biraz daha uzun |
Durum alanını okurken önceki değeri de saklayın. Örneğin bir siparişin processing’ten cancelled’a geçtiğini bilmek, stoğu geri eklemek için gereklidir; yalnız son durumu bilmek yetmez.
Pazaryeri senkronunda durum eşlemesi
Farklı kanalların siparişlerini tek listede göstermek için WooCommerce durumları ortak bir şemaya çevrilir. Aşağıdaki tablo Saystok’taki karşılıkları gösterir.
| WooCommerce | Ortak durum | Stok düşümüne etkisi |
|---|---|---|
| pending | Bekliyor | Düşülür |
| processing | Hazırlanıyor | Düşülür |
| on-hold | Beklemede | Ödeme onaylanana kadar düşülmez |
| completed | Teslim edildi | Düşülür |
| cancelled, failed, trash | İptal | Daha önce düşüldüyse geri eklenir |
| refunded | İade | Otomatik eklenmez, uyarı oluşur |
Sık sorulanlar
WooCommerce’te processing ile on-hold farkı nedir?
processing ödemenin alındığını, on-hold ödeme onayının beklendiğini gösterir. İkisinde de stok düşülmüştür.
Sipariş durumu API ile nasıl değiştirilir?
PUT /wp-json/wc/v3/orders/ID isteğinde gövdeye status alanını yazarsınız, ör. completed.
Durumu cancelled yapmak parayı iade eder mi?
Hayır. WooCommerce belgesine göre durumu değiştirmek para iadesi yapmaz; iade uç noktasını ya da paneldeki iade düğmesini kullanmanız gerekir.
failed siparişte stok ne olur?
Belgeye göre daha önce stok düşülmüşse sipariş Başarısız durumuna geçince adet stoğa geri eklenir.
Kaynaklar
İlgili WooCommerce API konuları
Son güncelleme: 27.10.2026 · WooCommerce API rehberinin tamamı