Shopify'ın faturalandırma kesinleştirme işlemi yanlış dönemi kullandığı için, kaydedilmiş faturalandırılabilir kullanım olsa bile uygulama kaldırıldıktan sonra nihai Shopify uygulama kullanım ücreti 0 $ görünebilir. Shopify, bu özel hatayı 30 Ekim 2026'da düzelttiğini ve incelemesinde tespit ettiği etkilenen kazançlar için düzeltme yaptığını belirtiyor. Ücretiniz hâlâ görünmüyorsa tamamlanmış dönemi kullanım kayıtlarınızla karşılaştırın ve kanıtları Partner Support ekibine iletin. Etkinlikleri yeniden göndermek çözüm değildir. Shopify'ın düzeltmeyle ilgili açıklaması
Önemli noktalar
- Doğrulanan hata, kaldırma işlemi faturalandırma dönemi sınırında iptali planladığında tamamlanan dönem yerine yeni açılan dönemi seçiyordu.
- Shopify, düzeltmenin tüm kullanıcılara sunulduğunu ve incelemesinde tespit ettiği önceden etkilenmiş kazançlar için düzeltme yaptığını belirtiyor.
202 AcceptedApp Events yanıtı, isteğin alındığını kanıtlar; faturalandırma doğrulamasının başarıyla tamamlandığını değil.- Kaldırma işleminden sonra, kaldırmadan önce gerçekleşmiş kullanım için kalan etkinlikleri göndermek üzere 24 saatiniz vardır. Ancak bu süre, kesinleştirilmiş 0 $ tutarındaki bir ücreti düzeltmez.
Aslında ne yanlış gitti?
Bildirilen vakada bir satıcı faturalandırılabilir kullanım oluşturdu, uygulamayı kaldırdı ve daha sonra sıfır birim ile $0.00 tutarında bir CHARGE_USAGE etkinliği oluştu. Shopify, kaldırma işlemi faturalandırma döneminin tam sınırında iptali planladığında, kesinleştirme işleminin sona eren dönem yerine yeni açılan dönemi okuyabildiğini doğruladı. Bu ayrım önemli: bu durum, satıcının ödeme yapmadığını ya da uygulamanın kullanımı bildirmediğini göstermez. Hem yalnızca kullanıma dayalı planların hem de hibrit planların ölçümlü kullanım bileşeni etkilenebilirdi. Shopify, 30 Ekim'de dönem seçimini düzelttiğini ve ertelenmiş iptal akışını doğruladığını bildirdi. İlk bildirimi ve Shopify'ın yanıtını okuyun.
Sıfır gelir oluşmasının başka nedenleri de vardır. Bu nedenle destek talebi açmadan önce hangi aşamada sorun çıktığını belirleyin. Shopify App Pricing etkinlikleri alır, bunları eşzamansız olarak doğrular, kabul edilen kullanımı ölçüm aracına göre toplar, ücreti hesaplar ve son olarak satıcının faturasını tahsil ettikten sonra kazançları öder. Bunlar tek bir başarılı API çağrısı değil, birbirinden farklı durumlardır. Shopify'ın kullanım ücreti belgeleri ve kazanç belgeleri bu adımları ayrı ayrı açıklar.
| Gözlemlediğiniz durum | Muhtemel inceleme alanı | Sonraki adım |
|---|---|---|
API 202 döndürdü, ancak faturalandırılabilir etkinlik görünmüyor | Ölçüm aracı tanıtıcısı veya eşzamansız doğrulama | Dev Dashboard'daki faturalandırma etkinliği günlüklerini kontrol edin |
Faturalandırma etkinliğinde PERIOD_CLOSED görünüyor | Etkinlik, izin verilen faturalandırma döneminin dışında geldi | Gerçekleşme ve gönderim zamanlarını kontrol edin |
Faturalandırma etkinliklerinde OK görünüyor, ancak nihai CHARGE_USAGE tutarı $0 | Kesinleştirme veya kullanım düzeltmesi | Tamamlanmış dönemi uygulama geçmişi ve kayıtlarınızla karşılaştırın |
| Ücret mevcut, ancak ödemelerde kazanç henüz görünmüyor | Satıcı faturası veya ödeme zamanlaması | Ücret ayrıntılarını ve ödeme durumunu inceleyin |
Hangi sorunla karşılaştığınızı kanıtlayın
Bu incelemeyi mevcut kurulum durumuna değil, değiştirilemez kullanım kayıtlarına dayandırırdım. Örneğin bir dışa aktarma uygulaması, ölçüm aracı etkinliğini bildirmeye çalışmadan önce tamamlanan dışa aktarma işlemini kaydetmelidir. Kayıtta mağaza kimliği, abonelik veya plan bağlamı, ölçüm aracı tanıtıcısı, miktar, gerçekleşme zaman damgası, idempotency anahtarı ve gönderim sonucu bulunmalıdır. Müşteri tanımlayıcılarını App Events yüküne eklemeden bir ücreti denetlemek için gereken kanıtları saklayın. Shopify'ın faturalandırma etkinliği kılavuzu, tanımlayıcı verilerin gönderilmemesi gerektiği konusunda açıkça uyarıyor.
Etkilenen her mağaza için:
- Tamamlanmış uygulama faturalandırma dönemini belirleyin ve ölçüm aracına göre başarılı kullanımın toplamını hesaplayın. İlgili planın sabit, kademeli veya hacim bazlı fiyatlandırmasını uygulayın. Bazı planlarda birim sayısını tek bir fiyatla çarpmak doğru sonucu vermez.
- Dev Dashboard'da Logs bölümünü açın, Type alanında App billing event filtresini seçin ve ilgili her etkinliğin durumunun
OKolduğunu kontrol edin. Eşleşmeyen bir ölçüm aracı tanıtıcısı yalnızca App event olarak görünebilir, billable event olarak görünmeyebilir. - Partner Dashboard'da mağazanın uygulama geçmişini ve ücret ayrıntılarını inceleyin. Uygulamanın kaldırılmasını, planlanan iptali, nihai
CHARGE_USAGEetkinliğini ve sonraki düzeltmeleri bulun. Net kazançları veya ödemeleri karşılaştırmadan önce brüt ücretleri beklenen brüt ücretlerle karşılaştırın. - Ödeme durumunu ayrıca kontrol edin. Shopify, bir ücretin ancak satıcıdan ödeme tahsil edildikten sonra kazanca dönüştüğünü belirtiyor. Bu nedenle ödemenin görünmemesi, tek başına 0 $ tutarındaki kesinleştirme hatasının kanıtı değildir.
Dev Dashboard doğrulama talimatları, 202 yanıtının neden yeterli olmadığını açıklar: faturalandırma hataları eşzamanlı bir hata yanıtı veya başarısızlık webhook'u döndürmez. Ücret ve ödeme kılavuzu ise tek tek ücretlerin nereden inceleneceğini gösterir.
Farkı büyütmeden kalan kullanımı gönderin
Shopify, kaldırma işleminden önce gerçekleşen kullanıma ait faturalandırma etkinliklerini göndermek için uygulamanın kaldırılmasından sonra 24 saat süre tanır. Bu süreden sonra gönderilen yeni etkinlikler PERIOD_CLOSED hatasıyla reddedilir. APP_UNINSTALLED etkinliği geldiğinde kurulumu etkisiz olarak işaretleyin, faturalandırılabilir yeni işler oluşturmayı durdurun ve tamamlanmış işleri temsil eden etkinlik kuyruğunu hızla boşaltın. Her etkinliğin ilk gerçekleşme zamanını ve değişmeyen idempotency anahtarını koruyun. Kullanım ücreti kuralları bu süreyi açıklar.
Faturalandırma outbox'ı küçük ve açık olmalıdır:
- Tamamlanan işi ve bekleyen faturalandırma etkinliğini birlikte kaydedin ya da bir outbox kullanın. Böylece çalışan işçi sürecinin çökmesi işlemin bir tarafının kaybolmasına yol açmaz.
- Taşıma hatalarını App Events API yanıt kurallarına göre yeniden deneyin ve aynı etkinlik için aynı idempotency anahtarını kullanın.
- API yanıtını kaydedin, ardından nihai faturalandırma sonucunu Dev Dashboard'dan doğrulayın. Gönderilen bir etkinlik
OKdurumunda değilse uyarı oluşturun.
Nihai tutar $0 çıktığında telafi etmek için kabul edilmiş kullanımı yeni anahtarlarla yeniden göndermeyin. Bu, ayrı bir etkinlik oluşturur, satıcıdan iki kez ücret alma riski doğurur ve kesinleştirilmiş dönemi düzeltmez. Shopify özellikle bunu yapmamayı önerdi. Kaldırma işleminden önce satıcıyı ücretsiz plana da zorlamayın: bir bildirimi yapan kişi bu yöntemde pozitif bir ücret gördü, ancak Shopify düzeltmeden sonra plan değişikliğinin gerekli olmadığını belirtti. Shopify'ın açıklaması
Etkilenen bir ücretin telafisini sağlayın
13 Kasım 2026 itibarıyla Shopify, daha önce etkilenen kazançlar için faturalandırma düzeltmelerini incelemesi sırasında tespit ettikleri kayıtlar kapsamında tamamladığını belirtiyor. Bu, itiraz edilen her kaydın tespit edildiği ya da bir uygulamanın kendi yerine geçen ücretini oluşturabileceği anlamına gelmez. Önce Partner Dashboard'da bir düzeltme olup olmadığını kontrol edin. Beklenen düzeltme görünmüyorsa mevcut Partner Support talebiniz üzerinden devam edin veya mağaza ve uygulama kimliklerini, abonelik bilgilerini, tamamlanan dönemin tarihlerini, kaldırma ve kesinleştirme zaman damgalarını, etkinliklerin idempotency anahtarlarını, OK faturalandırma sonuçlarını, hesapladığınız ücreti ve geçmişteki $0 kaydını içeren yeni bir talep açın. Hesaba özel tanımlayıcıları herkese açık forum gönderilerinde paylaşmayın. Shopify'ın telafi süreciyle ilgili yönlendirmesi
Sonraki teknik adım mutabakat işi oluşturmaktır: doğrulanmış kullanımı sıfırdan fazla olan her kaldırma işlemi için, tamamlanan dönemdeki beklenen ücreti Shopify'ın nihai ücreti ve sonraki düzeltmelerle karşılaştırın. Platform hatasının giderilmesi, bu sorunun yeni örneklerini önler. Bu karşılaştırma ise geçmişteki gelirin gerçekten telafi edilip edilmediğini gösterir.
Sıkça sorulan sorular
202 yanıtı, Shopify'ın kullanım etkinliği için ücret alacağı anlamına mı gelir?
Hayır. Bu yanıt, App Events API'nin isteği aldığını doğrular. Etkinliğin faturalandırma sonucunu Dev Dashboard'daki App billing event günlüklerinden kontrol edin.
Satıcı uygulamamı kaldırdıktan sonra kullanım etkinlikleri gönderebilir miyim?
Shopify, kaldırma işleminden önce gerçekleşen kullanıma ait kalan etkinlikleri göndermek için 24 saat süre tanır. Dönem kapandıktan sonra gönderilen etkinlikler PERIOD_CLOSED hatasıyla reddedilir.
Yanlışlıkla 0 $ olan nihai kullanım ücretini nasıl telafi edebilirim?
Önce Partner Dashboard'da bir faturalandırma düzeltmesi olup olmadığını kontrol edin. Düzeltme yoksa tamamlanan dönemin kullanım kayıtlarını, doğrulanmış etkinlik sonuçlarını, nihai ücreti ve ilgili tanımlayıcıları Partner Support ekibine iletin. Yeni idempotency anahtarlarıyla yerine geçecek etkinlikler oluşturmayın.