Kısa yanıt: Google Play, bir satın almanın geri ödendiğini veya iptal edildiğini öğrenmeniz için iki yol sunar. Gerçek Zamanlı Geliştirici Bildirimleri (RTDN), olaylar gerçekleştiği anda Google Cloud Pub/Sub üzerinden sunucunuza gönderilir. Voided Purchases API ise talep üzerine geçersiz kılınan satın almaların listesini çekmenizi sağlar. Bunlar birbirinin alternatifi değildir; RTDN size hız kazandırır, Voided Purchases API ise bir güvenlik ağı sağlar ve güvenilir bir kurulum hiçbir şeyin gözden kaçmaması için ikisini birden kullanır.
Google neden size iki mekanizma sunuyor
Google Play'de çoğu geri ödeme sizden habersiz gerçekleşir; Google bunları gerçekleştirir, yetkiyi iptal eder ve sizin göreviniz bunu öğrenerek uygulamanızın ve analizlerinizin doğru kalmasını sağlamaktır. (Neye itiraz edebileceğiniz ve neye edemeyeceğiniz hakkında bkz. Google Play Refunds & Chargebacks.)
Google, bunu öğrenmeniz için iki farklı araç sunar ve bu araçlar sorunu birbirine zıt yönlerden çözer. Biri olayları gerçekleştiği anda size iletir. Diğeri ise istediğiniz zaman bir liste talep etmenizi sağlar. Birlikte kullanıldıklarında birbirlerinin zayıf noktalarını kapatırlar; tek başlarına kullanıldıklarında ise her birinin bir boşluğu vardır.
Android geri ödeme takibine odaklanan geliştiriciler için bu farkı anlamak önemlidir, çünkü gerçek zamanlı bir olay akışı ile geçmişe dönük bir mutabakat mekanizması, geri ödeme izleme probleminin farklı kısımlarını çözer.
Gerçek Zamanlı Geliştirici Bildirimleri (push)
Gerçek Zamanlı Geliştirici Bildirimleri (RTDN), push mekanizmasıdır. Bir abonelikte veya satın almada bir şey gerçekleştiğinde -geri ödemeler ve geçersiz kılınan satın almalar da dahil olmak üzere- Google, backend'inizin abone olduğu bir Google Cloud Pub/Sub konusuna bir olay yayınlar. Buradaki amaç anlıklıktır: olayı saatler sonra keşfetmek yerine, gerçekleştiği ana yakın bir zamanda öğrenirsiniz.
RTDN Google Play entegrasyonu arayan geliştiriciler için bu, Google Play faturalandırma olaylarını backend'inizle bağlayan mekanizmadır. Yanıt vermek için yaklaşık 24 saatinizin olduğu chargeback incelemesi gibi zamana duyarlı her şey için bu anlıklık her şeydir. Periyodik kontrol yapmaya güveniyorsanız, zaten harcayamayacağınız zamanı çoktan kaybetmişsinizdir.
Püf nokta şu: RTDN, Pub/Sub üzerinde çalışır; bu da bir Google Cloud proje kurulumu, bir konu, Google Play için doğru yayınlama izinleri ve sizin tarafınızda bir abone gerektirir. Bu, tek bir webhook'tan çok daha fazla hareketli parça demektir ve birçok geliştiricinin takıldığı nokta tam da burasıdır.
Voided Purchases API (pull)
Google Play Voided Purchases API, pull mekanizmasıdır. Talep üzerine sorgulayabileceğiniz; geçersiz kılınmış, geri ödenmiş, chargeback'e uğramış veya iptal edilmiş siparişlerin listesini döndürür. Bir olayı beklemek yerine, doğrudan Google'a sorarsınız: neler geçersiz kılındı?
Gücü, eksiksizlik ve kurtarmadan gelir. Bir push bildirimi gecikirse, kaçırılırsa veya hiç işlenmezse, Google Play Voided Purchases API'ye yapılan bir pull isteği geçersiz kılınan satın almayı yine de ortaya çıkarır. Kayıtlarınızın Google'ınkiyle eşleştiğinden emin olmak için mutabakat yapmanızı bu şekilde sağlarsınız.
Bunun bedeli ise doğası gereği anlık olmamasıdır; sorguladığınız bir şeydir, bu yüzden tek başına bir tetikleyici değil, bir güvenlik ağıdır.
Neden birine değil, ikisine de ihtiyacınız var
İşte insanların kafasını karıştıran ayrım: bu, "daha iyisini seç" tarzında bir karar değil.
Yalnızca RTDN, size hız kazandırır ama eksiksizlik garantisi vermez; bir bildirimi kaçırır veya yanlış işlerseniz, o olay görüş alanınızdan tamamen kaybolur.
Yalnızca Voided Purchases API, size eksiksizlik sağlar ama hız sağlamaz; bir geri ödemeyi ancak bir sonraki sorgulamanızda öğrenirsiniz.
RTDN Google Play, backend'inize gerçek zamanlı bir sinyal verir; Google Play Voided Purchases API ise kaçırılan veya gecikmiş olaylar için mutabakat katmanını sağlar.
Güvenilir bir kurulum, RTDN'yi gerçek zamanlı tetikleyici, Voided Purchases API'yi ise push yönteminin kaçırdığı her şeyi yakalayan mutabakat katmanı olarak kullanır. Hız artı bir güvenlik ağı. Herhangi biri tek başına, er ya da geç düşeceğiniz bir boşluk bırakır.
İşlerin karmaşıklaştığı nokta
Bunu doğru şekilde kurmak göründüğünden daha fazla emek ister ve bu çaba tek seferlik değil, süreklidir:
Pub/Sub kurulumu. Konuyu oluşturmak, Google Play'e yayınlama hakkı vermek, backend'inizi abone yapmak ve izinleri tam doğru ayarlamak, bir ya da üç öğleden sonranızı yiyebilecek adımdır. Bu Pub/Sub Play Billing kurulumunun, faturalandırma altyapınız büyüdükçe de güvenilir kalması gerekir.
Senkronize tutulması gereken iki sistem. Artık bir push tüketicisi ve zamanlanmış bir pull-ve-mutabakat işi çalıştırıyorsunuz ve bunların birbirleriyle uyumlu olduğundan emin olmanız gerekiyor.
Yineleme giderme ve sıralama. Aynı olay size birden fazla kez veya sırasız şekilde ulaşabilir; işleme mantığınızın idempotent olması gerekir.
Güncel kalmak. Google, faturalandırma API'lerini ve olay türlerini revize eder; entegrasyonunuzun buna ayak uydurması gerekir, aksi halde sessizce güncelliğini yitirir.
Google Play geri ödeme bildirimleri. Sisteminizin, ilgili her Google Play geri ödeme bildirimini doğru şekilde işlemesi ve bunu doğru satın alma, yetki ve müşteri kaydıyla ilişkilendirmesi gerekir.
Tek tek bakıldığında bunların hiçbiri sıra dışı değil. Hepsi bir araya geldiğinde ise, zaten çoğunlukla itiraz edemeyeceğiniz geri ödemeleri doğru şekilde takip edebilme ayrıcalığı için kurulması ve sürdürülmesi gereken gerçek bir altyapı parçası ortaya çıkıyor.
Bunun geri ödeme yönetimine katkısı
Parçaları bir araya getirdiğinizde, Google Play geri ödeme yönetiminin iki yarısı olduğunu görürsünüz: itiraz edebileceğiniz tek şeyi (chargeback incelemesini) süresi içinde yakalamak ve itiraz edemeyeceğiniz her şeyi, yetkileriniz ve analizleriniz doğru kalsın diye eksiksiz kaydetmek. Her iki yarı da sağlam bir RTDN + Voided Purchases temeline bağlıdır.
Google Play geri ödemelerinin RTDN ve Voided Purchases API ile nasıl takip edileceğini merak eden ekipler için yanıt şudur: hızlı olay tespiti için RTDN'yi, mutabakat ve kurtarma için Voided Purchases API'yi kullanın. Bu, backend'inize geri ödemeler, geçersiz kılınan satın almalar ve chargeback'ler hakkında çok daha eksiksiz bir tablo sunar.
RefundSensor'ın sizin için yönettiği katman tam olarak budur. Pub/Sub konusunu otomatik olarak oluşturur, böylece Play Console'a yalnızca tek bir konu adı yapıştırmanız yeterli olur; RTDN'yi gerçek zamanlı olarak tüketir; hiçbir şeyin kaçmaması için geçersiz kılınan satın almalarla mutabakat yapar; chargeback incelemelerinde süresi içinde bir ret önerisi gönderir ve diğer tüm geri ödemeleri, Apple geri ödemelerinizle birlikte tek bir dashboard'da kaydeder. İki mekanizmayı da kurmak veya sürdürmek zorunda kalmadan, doğru bir iki-mekanizmalı kurulumun sonucunu elde edersiniz.
Resmi kaynaklar {#official-sources}
Google'ın faturalandırma API'leri değişebilir, bu yüzden belgelerini nihai otorite olarak kabul edin:
Tek kurulum, iki mekanizma, sıfır bakım. RefundSensor, Pub/Sub'ı otomatik olarak oluşturur, RTDN'yi gerçek zamanlı olarak tüketir, geçersiz kılınan satın almalarla mutabakat yapar ve Google Play ile Apple için chargeback incelemelerini tek bir dashboard'da yönetir. Ücretsiz başlayın →
Yayınlandıktan sonra eklenecek iç bağlantılar: Google Play refunds cornerstone · Apple refund automation cornerstone · the 12-hour window.
Sık sorulan sorular
RTDN, olayları Pub/Sub üzerinden sunucunuza gerçek zamanlı olarak gönderir; Voided Purchases API ise talep üzerine geçersiz kılınan siparişlerin listesini çekmenizi sağlar. RTDN size hız kazandırır, Voided Purchases API ise eksiksizlik sağlar.
Güvenilir bir kurulum için evet. RTDN gerçek zamanlı tetikleyiciniz, Voided Purchases API ise push yönteminin kaçırdığı her şey için mutabakat güvenlik ağınızdır. Her biri tek başına bir boşluk bırakır.
Genellikle bir geri ödeme, chargeback veya iptal nedeniyle artık geçerli olmayan bir sipariştir. Geçersiz kılınan satın almaları takip etmek, yetkilerinizin ve analizlerinizin doğru kalmasını sağlar.
RTDN, Google Cloud Pub/Sub üzerinde çalışır; bu nedenle bir konu (topic), Google Play için yayınlama izinleri ve sizin tarafınızda bir abone gerektirir, yani tek bir URL yapıştırmaktan çok daha fazla hareketli parça vardır. RefundSensor, bu zorluğu ortadan kaldırmak için Pub/Sub konusunu otomatik olarak oluşturur.
Çoğunlukla hayır. Olağan geri ödemelere ve iptallere Google karar verir. İtiraz edebileceğiniz tek durum, incelemedeki bir chargeback'tir; bunu RTDN aracılığıyla yakalamanız ve yaklaşık 24 saatlik süresi içinde yanıtlamanız gerekir.
