Tüm makaleler
Derinlemesine inceleme7 dk okuma

Play Billing Library 8 artık her Google Play güncellemesi için zorunlu ve iade takibini sunucunuza taşıyor

Google'ın Play Billing Library 7 için verdiği ek süre 1 Kasım 2026'da doldu, bu yüzden yeni uygulamalar ve güncellemeler artık sürüm 8 veya üstünü gerektiriyor. Sürüm 8 queryPurchaseHistory() çağrısını kaldırdı, yani iade edilen ve tüketilen satın alımların sunucu tarafında takip edilmesi gerekiyor. Neyin değiştiğini ve yavaş bir geçişin neye mal olduğunu anlatıyoruz.

Sabah ışığında bir Android geliştiricisinin masası, üzerinde bir dizüstü bilgisayar, bir telefon ve duvarda bir tarihi daire içine alınmış bir takvim, Play Billing Library 8'in Google Play güncellemeleri için asgari sürüm olduğu hafta

Önemli noktalar

  • Google'ın kullanımdan kaldırma tablosu, Play Billing Library 7 ile yeni uygulama ve güncelleme yayınlamak için son günü 31 Ağustos 2026 olarak belirledi ve ek süreler 1 Kasım 2026'da sona erdi. Bu yüzden her Google Play güncellemesi artık Play Billing Library 8 veya üstünü gerektiriyor.
  • Play Billing Library 7 ile zaten yayında olan uygulamalar çalışmaya devam ediyor, çünkü Google'a göre kullanımdan kaldırma yalnızca yeni uygulamaları ve güncellemeleri engelliyor, mevcut kurulumları değil.
  • Play Billing Library 8 queryPurchaseHistory() çağrısını kaldırdı ve Google'ın önerdiği yol sunucu tarafında. Tüketilen satın alımları kendi backend'inizde takip edin, iade edilen veya iptal edilenleri Voided Purchases API üzerinden alın.
  • Google Play Voided Purchases API yalnızca son 30 gündeki geçersiz kılınan satın alımları gösteriyor ve uygulama başına günde 6,000 sorguya ve herhangi bir 30 saniyelik dilimde 30 sorguya izin veriyor.
  • Uygulama bir satın alımı üç gün içinde onaylamazsa Google Play hâlâ bedeli otomatik olarak iade ediyor ve hakkı geri alıyor. Bozuk bir Play Billing Library 8 geçişi bunu her satışta tetikleyebilir.
  • Google Play'in ters ibraz incelemesi, geliştiriciden kanıt isteyen tek Android iade akışı. Kanıt, PendingRefundReviewNotification'dan sonraki 24 saat içinde orders.reviewrefund ile gönderiliyor.
  • 3 Ağustos 2026'dan sonra verilen Google Play siparişlerinde, kaybedilen her ters ibrazda geliştirici satın alma bedelini, Play'in hizmet ücreti düşülmüş olarak, ve bankanın ters ibraz ücretlerini ödüyor.

Google Play üzerinden satış yapan her Android uygulaması artık bir sonraki güncellemesinde Play Billing Library 8 veya üstünü göndermek zorunda. Sürüm 7 için yeni uygulama ve güncelleme son tarihi 31 Ağustos 2026 idi ve son ek süreler 1 Kasım 2026'da doldu. Tarihler Google'ın kullanımdan kaldırma SSS sayfasındaki bir tabloda yer alıyor, hatırlatmalar ise Play Console'daki Policy status sayfasında uyarı olarak geliyor.

Çoğu ekip için bu bir bağımlılık güncellemesi ve birkaç yeniden adlandırılmış metot demek. İadeler söz konusu olduğunda ise daha fazlası. Play Billing Library 8, bir uygulamanın geçmiş satın alımlara bakmasını sağlayan tek istemci çağrısını sildi. Bundan sonra bir kullanıcının ne satın aldığını, neyi tükettiğini veya neyin iadesini aldığını bilmek istiyorsanız, bunu sunucunuzun hatırlaması gerekiyor.

Play Billing Library 8 son tarihi gerçekte neyi engelliyor

Google her kütüphane sürümüne iki yıllık bir ömür veriyor. Kullanımdan kaldırma yalnızca yeni uygulamaları ve güncellemeleri durduruyor. Google'ın SSS sayfasına göre mevcut uygulamalar çalışmaya devam ediyor ve bakımı yapılmayan APK'ların güncellenmesi gerekmiyor. Yani artık dokunmadığınız bir uygulamada bugün hiçbir şey bozulmuyor. Bir düzeltme, yeni bir fiyat veya yeni bir ödeme duvarı göndermeye çalıştığınız gün bozuluyor.

Kütüphane sürümüYeni uygulama ve güncelleme son tarihiEk süre son tarihi
631 Ağustos 20251 Kasım 2025
731 Ağustos 20261 Kasım 2026
831 Ağustos 20271 Kasım 2027
931 Ağustos 20281 Kasım 2028

Sürüm 8.0.0 30 Haziran 2025'te yayımlandı. Sürüm 9.0.0 ise 19 Mayıs 2026'da geldi. Şimdi geçiş yapıyorsanız, doğrudan 9'a geçmek size 8'de durmaya göre bir yıl daha kazandırır.

Play Billing Library 8 iadeler için neden önemli

En dikkat çekici kaldırma queryPurchaseHistory(). Sürüm 7'de kullanımdan kaldırıldı ve sürüm 8.0.0'da tamamen silindi. Google'ın geçiş notları eski işlevini üç parçaya ayırıyor ve bunlardan yalnızca biri cihazda kalıyor.

queryPurchaseHistory() ile ne yapıyordunuzGoogle şimdi ne kullanmanızı söylüyorNerede çalışıyor
Aktif ve bekleyen satın alımlarqueryPurchasesAsync()Cihazda
Tüketilen tek seferlik satın alımlarKendi kayıtlarınızSunucunuz
İade edilen, iptal edilen veya ters ibraz edilen satın alımlarVoided Purchases APISunucunuz
Bir kullanıcının tüm satın alma geçmişiKendi kayıtlarınızSunucunuz

Android'de tüketilebilir satın alımları hâlâ geri yükleyebilir miyim?

İstemciden yükleyemezsiniz. queryPurchasesAsync() yalnızca aktif olanları döndürür, bu yüzden tüketilmiş bir kredi paketi veya bitmiş bir mücevher paketi bu çağrıyla asla geri gelmez. Bir kullanıcı uygulamayı yeniden kurup jetonlarının nereye gittiğini sorarsa, cevap satın alma anında tuttuğunuz kayıt defterinden gelmelidir. Satın alma geçmişini ücretsiz bir yedek olarak kullanan uygulamalar bu yedeği kaybetti.

Artık iadelerden nasıl haberdar olurum?

Sunucu tarafında iki kanal var. Gerçek zamanlı geliştirici bildirimleri; satın alma jetonunu, sipariş kimliğini, ürün türünü ve iade türünü içeren bir VoidedPurchaseNotification gönderir. İade türü ya tam iade ya da miktara dayalı kısmi iadedir. Voided Purchases API ise aynı olayları zaman aralığına göre çekmenizi sağlar ve kaçırdığınız her şey için bir yedek görevi görür.

Bu çekme API'sinin katı sınırları var. Yalnızca son 30 gündeki geçersiz kılınan satın alımları gösterir. Her uygulama günde 6,000 sorgu ve herhangi bir 30 saniyelik dilimde 30 sorgu hakkına sahiptir. Ayrıca geri alma seçeneği olmadan yapılan bir geliştirici iadesi hiç döndürülmez. Beş hafta kapalı kalan bir sunucu, bir daha asla çekemeyeceği iadeleri kaybeder.

Sessiz bir sunucu koridorunda tablet tutan bir mühendis, Play Billing Library 8 istemci tarafındaki satın alma geçmişini kaldırdıktan sonra iade edilen ve tüketilen Google Play satın alımlarının artık kaydedilmesi gereken yer

Geliştiricinin hâlâ söz sahibi olduğu iadeler

İade takibini sunucuya taşımak size iadeler üzerinde daha fazla kontrol vermez. Google Play iadelerinin neredeyse tamamı sizsiz karara bağlanır: self servis iadeler, destek iadeleri, iptaller ve onaylanmamış satın alımlardaki otomatik iadeler. Bunları sonradan, geçersiz kılınan satın alma bildirimiyle öğrenirsiniz.

İstisna ters ibraz incelemesidir. Bir alıcı sizin görüşünüzü gerektiren bir ters ibraz başlattığında Google bir PendingRefundReviewNotification gönderir. Google'a göre 24 saat içinde orders.reviewrefund çağrısı yaparak bir iade önerisi ve kullanım kanıtıyla yanıt vermeniz gerekir. Bu kanıt, yeni kütüphanenin tutmanızı zorunlu kıldığı sunucu kayıtlarının ta kendisinden gelir. Geri yükleme için kayıt defteri tutan bir ekip, yanıt vermek için gereken her şeye zaten sahiptir.

Yavaş bir geçişin parasal maliyeti

Doğrudan risk üç gün kuralıdır. Uygulamanız bir satın alımı üç gün içinde onaylamazsa Google Play bedeli otomatik olarak iade eder ve hakkı geri alır. Bekleyen satın alımlarda süre, satın alma PENDING durumundan PURCHASED durumuna geçtiğinde başlar. Bağlantı mantığını, yeni queryProductDetailsAsync() dinleyicisini veya bekleyen satın alma kurulumunu bozan bir geçiş, satışları durdurmadan onayları durdurabilir. O aralıktaki her sipariş tamamen iade edilir ve kullanıcı ödediği şeyi zaten almıştır.

Asıl acı veren kısım burası. İade edilen bir görsel kredi paketi, her üretimin arkasındaki GPU süresini çoktan harcamıştır. İade edilen bir yapay zekâ planı, ücretli API çağrılarını çoktan çalıştırmıştır. İade edilen bir depolama katmanı, parasını ödediğiniz diskleri çoktan doldurmuştur. İade edilen bir bahşiş, bir içerik üreticisinin ödemesine çoktan gitmiştir. İade, geliri alıcıya geri verir ve bu faturaları size bırakır.

Ters ibrazlar da pahalılaştı. Google'ın yardım merkezine göre 3 Ağustos 2026'dan sonra verilen siparişlerde geliştirici, satın alma bedelini, Play'in hizmet ücreti düşülmüş olarak, ve bankanın ters ibraz ücretlerini karşılıyor. Google yalnızca kendi hizmet ücretini ödemeye devam ediyor. Bir ters ibraz incelemesine 24 saat içinde gerçek kullanım verisiyle yanıt veremeyen bir uygulama, bu faturanın tamamını her seferinde öder.

Geliri koruyan bir geçiş kontrol listesi

  • Bağımlılığı Play Billing Library 8 veya 9'a yükseltin ve queryPurchaseHistory(), querySkuDetailsAsync() ile argümansız enablePendingPurchases() çağrılarını kaldırın.
  • queryProductDetailsAsync() dinleyicinizi güncelleyin. Sürüm 8'den beri getirilemeyen ürünleri de bir durum koduyla döndürüyor.
  • Kopan bir faturalandırma bağlantısı satın alma işlemesini durdurmasın diye enableAutoServiceReconnection() özelliğini açın.
  • Uygulama kapalıyken tamamlanan satın alımlar da üç gün içinde onaylansın diye onResume() içinde queryPurchasesAsync() çağırın.
  • Her satın alma jetonunu, sipariş kimliğini ve tüketimi kendi hesap kimliğinize bağlayarak sunucunuzda kaydedin.
  • Gerçek zamanlı geliştirici bildirimlerine abone olun ve hem VoidedPurchaseNotification hem de PendingRefundReviewNotification olaylarını işleyin.
  • Güvenlik ağı olarak her gün bir Voided Purchases API senkronizasyonu çalıştırın, 30 günlük pencerenin ve 6,000 sorguluk günlük kotanın rahatça içinde kalarak.

RefundHalt, Google Play'in geçersiz kılınan satın alma ve ters ibraz incelemesi bildirimlerini dinler, her incelemeye 24 saatlik süre içinde gerçek kullanım verilerinizle orders.reviewrefund üzerinden yanıt verir ve uygulamanızın artık cihazdan isteyemediği iade geçmişini saklar.

Sık sorulan sorular

Artık Play Billing Library 8 kullanmak zorunda mıyım?
Evet, Google Play faturalandırması ile satış yapan her yeni uygulama veya güncelleme için. Google'ın kullanımdan kaldırma tablosu sürüm 7 için son tarihi 31 Ağustos 2026 olarak belirledi ve ek süreler 1 Kasım 2026'da sona erdi. Sürüm 8'i veya daha yeni olan sürüm 9'u kullanabilirsiniz.
Mevcut uygulamam hâlâ Play Billing Library 7 kullanıyorsa çalışmayı durdurur mu?
Hayır. Google'a göre mevcut uygulamalar çalışmaya devam ediyor ve bakımı yapılmayan APK'ların güncellenmesi gerekmiyor. Kullanımdan kaldırma yalnızca desteklenmeyen bir sürüm kullanan yeni bir uygulama veya güncelleme yayınlamanızı engelliyor.
Play Billing Library 8'de queryPurchaseHistoryAsync yerine ne geldi?
Cihazda aynı işi yapan bir şey yok. Google; aktif ve bekleyen satın alımlar için queryPurchasesAsync() kullanmanızı, tüketilen satın alımları kendi sunucunuzda takip etmenizi ve iptal edilen veya iade edilen satın alımlar için Voided Purchases API kullanmanızı söylüyor.
Google Play Voided Purchases API ne kadar geriye gidiyor?
30 gün. Google'a göre API yalnızca son 30 gün içinde gerçekleşen geçersiz kılınan satın alımları gösterebiliyor ve her uygulamayı günde 6,000 sorgu ve herhangi bir 30 saniyelik dilimde 30 sorgu ile sınırlıyor.
Uygulamam bir satın alımı onaylamazsa Google Play bedelini iade eder mi?
Evet. Bir satın alım üç gün içinde onaylanmazsa kullanıcı otomatik olarak iade alır ve Google Play satın alımı geri alır. Bekleyen satın alımlarda üç gün, durum PENDING değerinden PURCHASED değerine geçtiğinde başlar.

Kaynaklar ve ek okumalar

RefundHalt

App Store ve Google Play için geri ödeme otomatik pilotu

Okumaya devam edin

Bir sonraki geri ödeme talebi şimdiden yolda.

İtiraz edemediğiniz bir geri ödemeyle ilgili başka bir destek e-postasını okumak için gereken sürede RefundHalt'ı kurun.