Bir Google Play satın alması iade edildiğinde veya ters ibraz edildiğinde, bunu Voided Purchases API ile öğrenirsiniz

Google Play'de bir iade kapınızı çalmaz. Para hareket eder, müşteri uygulamayı açık tutar ve siz arayıp bakmadığınız sürece sizin tarafınızda hiçbir şey değişmez. Voided Purchases API, arayıp baktığınız yerdir. Size iptal edilen, iade edilen veya ters ibraz edilen siparişlerin bir listesini verir, böylece müşterinin artık ödemediği şeye erişimi geri alabilirsiniz. Zamanlanmış bir işi ona yöneltin, listeyi okuyun, yetkiyi kesin. Döngünün tamamı budur.

Çoğu ekibi yolundan çıkaran bir tuzak var ve o kodun içinde değil. Burada yalnızca geri alınan siparişler görünür. Play Console'da geri alma seçeneğini işaretlemeden bir satın almayı iade ederseniz, o sipariş bu API'ye asla ulaşmaz ve iade edilen bir müşteri sattığınız her şeyi elinde tutarken işiniz sorunsuz çalışır. Bu yazı API'yi alan alan, onu sınırlayan sayıları ve bunu atladığınızda paranın nereden sızdığını adım adım ele alır.

Voided Purchases API aslında neyi döndürür

API tek bir soruyu yanıtlar: bu uygulamanın hangi siparişleri son zamanlarda geçersiz kılındı. Geçersiz kılma (void), hepsi müşterinin parasını geri almasıyla biten üç sonucu kapsar. Bir iptal, bir iade veya bir ters ibraz. Tek seferlik uygulama içi ürünlere ve aboneliklere uygulanır ve kapsamı tek bir parametreyle seçersiniz. type'ı 0 yapın, yalnızca geçersiz kılınan uygulama içi ürün satın almalarını alırsınız, ki bu varsayılandır. 1 yapın, geçersiz kılınan uygulama içi satın almaları ve geçersiz kılınan abonelik satın almalarını birlikte alırsınız.

Listedeki her giriş bir voided purchase nesnesidir. Alanlar azdır ve her biri önemlidir.

Bir voided purchase üzerindeki alanlar

Harekete geçmeden önce voidedReason'ı okuyun

voidedReason, ham bir listeyi bir karara dönüştüren alandır. Bir alıcı pişmanlığı iadesi ve bir banka ters ibrazı ikisi de aynı listeye düşer, ama aynı olay değildirler ve ağustos fiyatlandırması bunlardan birini pahalı hale getirir. İşte tam liste.

30 günlük pencere, listenizi boşaltan tuzaktır

Voided Purchases API yalnızca son 30 gündeki geçersiz kılınan satın almaları gösterebilir. startTime parametresi varsayılan olarak şu anki zaman eksi 30 gündür ve bundan daha eskiye ayarlanamaz. endTime varsayılan olarak şimdidir. Yani uç nokta bir arşiv değil, bir aylık kayan bir penceredir.

Sonuç serttir. Sorgulama işiniz bozulur ve beş hafta boyunca kimse fark etmezse, birinci haftanın geçersiz kılmaları API'den zaman aşımına uğramış olur. Onları geri getiren hiçbir çağrı yoktur. O siparişleri geri almazsınız ve başka bir şekilde yakalamadıysanız var olduklarını bile bilmezsiniz. API, en kötü kesintinizin boyutunda bir deliği olan bir güvenlik ağıdır.

Geri alma seçeneği, bir siparişin görünüp görünmeyeceğine karar verir

Bu, bir ekibin API'yi bozuk olarak bildirmesinin en yaygın nedenidir. Yalnızca geri alınan siparişler döndürülür. Kullanıcı kaynaklı iadeler, iptaller, ters ibrazlar ve Google kaynaklı iadeler her zaman geri alınır, bu yüzden her zaman görünürler. Geliştirici kaynaklı bir iade farklıdır. Bir siparişi Play Console veya Orders API aracılığıyla kendiniz iade ettiğinizde, onu ayrıca geri alıp almayacağınızı seçersiniz. Geri almadan iade edin, sipariş müşteriyle çözülür ama Voided Purchases API'de asla ortaya çıkmaz.

Bundan çıkan kural basittir. Amacınız erişimi çekmekse, geri alma seçeneği açıkken iade edin. Aksi takdirde parayı geri vermiş ve kapıyı açık bırakmışsınızdır ve ne kadar iyi yazılmış olursa olsun geri alma işinizin üzerinde hareket edeceği hiçbir şey yoktur.

Kotayı tetiklemeden nasıl sorgulanır

Uç nokta hız sınırlıdır ve sınırlar, naif bir döngünün onlara takılacağı kadar düşüktür. Günde 6,000 sorgu (Pasifik Saati'ne göre sayılır) ve herhangi bir 30 saniyelik dönemde en fazla 30 sorgu alırsınız. Bu bütçe pencereli sorgulama için uygundur ve sipariş başına bir istek tasarımlarına düşmandır.

Sorgu pencereleri ve devam belirteci

maxResults varsayılan olarak 1,000'dir, ki bu aynı zamanda üst sınırdır. Bir pencere bir sayfadan fazla geçersiz kılma barındırdığında, yanıt bir nextPageToken içeren bir tokenPagination nesnesi taşır. Sayfalarda gezinmek için o belirteci sonraki çağrıya geri geçirin. İlgilendiğiniz pencereyi sınırlamak için startTime ve endTime ayarlayın, belirteç tükenene kadar sayfalayın, sonra pencereyi ilerletin. Bu desen sizi hem 30 saniyelik patlama sınırı hem de günlük tavan içinde tutar.

Real-time developer notifications boşluğu kapatır

Her gün sorgulamak yine de bir güne kadar körlük bırakır ve 30 günlük pencere uzun boşlukları cezalandırır. Real-time developer notifications gecikmeyi ortadan kaldırır. Google, bir satın alma geçersiz kılındığı anda sahibi olduğunuz bir Cloud Pub/Sub konusuna bir VoidedPurchaseNotification yayınlar ve arka ucunuz onu saniyeler içinde tüketir. Mesaj küçüktür.

Bunun size para açısından maliyeti

API bir tesisattır, ama onu bağlamanın nedeni bir faturadır. O listedeki her geçersiz kılma gerçek bir sayıya karşılık gelir ve bunlardan ikisi daha pahalı hale geliyor.

Ters ibraz faturası 3 Ağustos 2026'dan itibaren size geliyor

3 Ağustos 2026'dan itibaren Google, bir ters ibrazın maliyetini geliştiriciye kaydırıyor. Satın alma fiyatını kaybedersiniz ve üstüne bankanın ters ibraz ücretini ödersiniz. 7 olan bir voidedReason artık sadece kaybedilmiş bir satış değil, ekli bir ücreti olan bir gider kalemidir. Bir ters ibrazı geri alamazsınız, o bankada kesindir, ama sonrasındaki kanamayı durdurabilirsiniz. Geçersiz kılmayı hızlı yakalamak, yetkiyi geri almanıza ve hâlâ sunduğunuz her şey için, iade edilen ve sonra geri çevrilen bir müşteriye harcama yapmayı durdurmanıza olanak tanır.

İade edilen bir müşteriye hizmet vermek için ödemeye devam edersiniz

Bir geçersiz kılma ortaya çıktığı anda satın alma fiyatı gitmiştir. Hâlâ kontrol ettiğiniz şey, sunmaya devam etmenin maliyetidir. İade edilen bir yetki canlı kaldığı her saat, müşterinin artık finanse etmediği şeyler için ödemeye devam edersiniz: işlem gücü, model API çağrıları, depolama ve onların kullanımına bağlı herhangi bir içerik üreticisi veya ortak ödemesi. Bu API tarafından yönetilen bir geri alma sistemi, o sayacı kapatmanın yoludur. Onu atlayın, mağazanın zaten tazmin ettiği kişiler için ürünü finanse etmiş olursunuz.

friendly fraud, eğilimini takip etmeye değer bir örüntüdür

5 veya 6 olan bir voidedReason tek seferlik değildir. Fraud ve friendly fraud hesaba göre, cihaza göre ve bazen kampanyaya göre kümelenir. API size her geçersiz kılmada voidedSource ve voidedReason'ı verir, bu da her geri çevrilmeyi izole bir maliyet olarak ele almak yerine kötüye kullanımın eğilimini hesaba göre takip etmeye yeter. İki kez ters ibraz yapan bir müşteri, ilk iadenin söylemediği bir şeyi size söylüyor.

RefundHalt tarzında bağlama

Tüm parçaları elinizde tuttuğunuzda model küçüktür. Hiçbir şey tam bir gün beklemesin diye VoidedPurchaseNotification'ı gerçek zamanlı olarak dinleyin. Abonelik yenilemeleri asla karışmasın diye orderId üzerinde anahtarlayarak doğruluk kaynağı olarak Voided Purchases API'yi çağırın. Bir ters ibraz bir pişmanlık iadesinden farklı ele alınsın diye voidedSource ve voidedReason'ı okuyun. 30 günlük pencere asla ısırmayacak kadar sıkı bir programla sorgulayın ve amacınız erişimi kesmek olduğunda her zaman geri alma seçeneği açıkken iade edin.

Bu, RefundHalt'in sizin için çalıştırdığı kısımdır. Gerçek zamanlı bildirimleri tüketir, her geçersiz kılmayı API ile mutabık kılar, tüm ürün yerine tam siparişi geri alır ve pahalı olanlar gömülmek yerine işaretlensin diye bir banka ters ibrazını sıradan bir iadeden ayırır. Kendiniz bir Pub/Sub hattı ve bir sorgulama işi kurmadan, saniyeler içinde erişim geri alınır ve kimin neyi neden geçersiz kıldığının bir kaydını elde edersiniz.