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.

Ö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 tarihi | Ek süre son tarihi |
|---|---|---|
| 6 | 31 Ağustos 2025 | 1 Kasım 2025 |
| 7 | 31 Ağustos 2026 | 1 Kasım 2026 |
| 8 | 31 Ağustos 2027 | 1 Kasım 2027 |
| 9 | 31 Ağustos 2028 | 1 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ıyordunuz | Google şimdi ne kullanmanızı söylüyor | Nerede çalışıyor |
|---|---|---|
| Aktif ve bekleyen satın alımlar | queryPurchasesAsync() | Cihazda |
| Tüketilen tek seferlik satın alımlar | Kendi kayıtlarınız | Sunucunuz |
| İade edilen, iptal edilen veya ters ibraz edilen satın alımlar | Voided Purchases API | Sunucunuz |
| Bir kullanıcının tüm satın alma geçmişi | Kendi kayıtlarınız | Sunucunuz |
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.

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ızenablePendingPurchases()ç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çindequeryPurchasesAsync()ç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
VoidedPurchaseNotificationhem dePendingRefundReviewNotificationolayları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
- Android Developers: Play Billing Library deprecation FAQ
- Android Developers: Play Billing Library release notes
- Android Developers: Migrate to Play Billing Library 8
- Android Developers: Query purchase history alternatives
- Android Developers: Integrate the Google Play Billing Library into your app
- Android Developers: Real-time developer notifications reference
- Google Play Developer API: Voided Purchases API
- Play Console Help: Chargeback cost sharing for orders after August 3, 2026
RefundHalt
App Store ve Google Play için geri ödeme otomatik pilotu
Okumaya devam edin
Brezilya artık hangi oyunların çocuklara hâlâ ganimet kutusu sattığını kontrol ediyor ve faturanın kesildiği yer ganimet kutusu iadeleri
Brezilya Adalet Bakanlığı, veri koruma otoritesinden yaş kontrolü yapmadan ganimet kutusu satan altı oyunu izlemesini istedi. Yasanın ne şart koştuğunu, Apple ve Google'ın zaten neyi talep ettiğini ve kutu çoktan açılmışken ganimet kutusu iadelerini nasıl fiyatlayıp yöneteceğinizi anlatıyoruz.
Yanlışlıkla yapılan uygulama içi satın almalar kazanamayacağınız iadelerdir, bu yüzden çözüm satın alma ekranınızdadır
Yanlışlıkla yapılan uygulama içi satın almalar her iki mağazada da iade olarak geri döner ve hiçbir kullanım kanıtı dokunuşun bilerek yapıldığını kanıtlamaz. Apple ve Google'ın bunları nasıl etiketlediğini, her birinin size işlem gücü ve ödemeler açısından neye mal olduğunu ve ücret oluşmadan önce bunları durduran satın alma ekranı tasarımını anlatıyoruz.