Powiadomienie o anulowanym zakupie pozwala Twojemu serwerowi Google Play odebrać dostęp w chwili, gdy pojawia się zwrot

Zwrot w Google Play nie musi być czymś, co odkrywasz później w raporcie. Google Play może wypchnąć do Twojego serwera powiadomienie o anulowanym zakupie w chwili, gdy zakup zostaje anulowany, niezależnie od tego, czy kupujący skorzystał ze zwrotu samoobsługowego, agent wsparcia go przyznał, bank wymusił obciążenie zwrotne, czy sam zwróciłeś zamówienie z włączoną flagą odebrania. Wiadomość jest maleńka, wskazuje dokładny zakup i niesie jedną instrukcję, oddaj uprawnienie, ponieważ pieniędzy już nie ma.

Czym właściwie jest powiadomienie o anulowanym zakupie

Powiadomienie o anulowanym zakupie to jeden z typów Real-time Developer Notifications Google Play, czyli RTDN. RTDN to kanał push. Google publikuje wiadomość do tematu Cloud Pub/Sub, który posiadasz, a Twój backend odbiera ją w ciągu chwil od zdarzenia, zamiast dowiadywać się o nim przy następnym zaplanowanym odpytywaniu. To cała istota powiadomienia o anulowanym zakupie w porównaniu ze starszą ścieżką pull: dowiadujesz się o zwrocie, gdy się dzieje, a nie godziny później.

Ścieżka pull nadal istnieje i nadal ma znaczenie. Voided Purchases API pozwala Twojemu serwerowi zapytać, według własnego harmonogramu, o listę zakupów anulowanych w danym przedziale czasu. Oba rozwiązania się uzupełniają. Powiadomienie mówi Ci w chwili, gdy jeden zakup się zmienia; API pozwala uzgadniać zbiorczo i uzupełniać wszystko, co pozostawiłaby pominięta wiadomość.

Podróżuje wewnątrz Real-time Developer Notification

Powiadomienie o anulowanym zakupie nigdy nie przychodzi samo. Znajduje się wewnątrz opakowania DeveloperNotification, a to opakowanie jest dostarczane jako pojedynczy ciąg zakodowany w base64 w polu data wiadomości Pub/Sub. Twój handler dekoduje ten ciąg do JSON, zanim będzie mógł cokolwiek odczytać. Opakowanie zawsze wskazuje aplikację i czas zdarzenia oraz zawiera dokładnie jeden obiekt powiadomienia spośród pięciu, które definiuje Google. Wykluczają się one wzajemnie, więc wiadomość niosąca voidedPurchaseNotification nie będzie jednocześnie nieść zdarzenia subskrypcji ani jednorazowego.

Cztery pola, które niesie

Zdejmij opakowanie, a samo powiadomienie o anulowanym zakupie to cztery pola. To celowo oszczędne. Stanowisko Google jest takie, że jeśli wszystko, czego potrzebujesz, to odnaleźć właściwy zakup i skorygować uprawnienie, te cztery pola wystarczą i nie musisz wywoływać żadnego API, aby zadziałać.

productType mówi Ci, co zostało anulowane

productType to mała liczba całkowita, która decyduje, którą z Twoich ścieżek odbierania obrać. Anulowanie subskrypcji musi rozwikłać trwający dostęp; anulowanie zakupu jednorazowego po prostu usuwa pojedyncze uprawnienie.

refundType mówi Ci, ile wróciło

refundType oddziela czyste pełne odwrócenie od częściowego. Przypadek częściowy jest wąski. Pojawia się tylko wtedy, gdy wieloilościowy zakup jednorazowy miał zwróconą część, ale nie całą swoją ilość.

Najpierw to włącz, bo inaczej nigdy nie przyjdzie

Powiadomienia o anulowanych zakupach nie płyną domyślnie. Włączasz RTDN raz, w Play Console, i kierujesz je na temat Pub/Sub, który kontrolujesz. Przełącznik znajduje się w Monetize, następnie Monetization setup, w sekcji Real-time developer notifications na górze strony. Zaznacz Enable real-time notifications, następnie wklej pełną nazwę tematu w formacie projects/{project_id}/topics/{topic_name} i użyj Send Test Message, aby potwierdzić, że kanał działa, zanim mu zaufasz.

Przełącznik treści to miejsce, w którym ludzie pomijają anulowane zakupy. Oba wybory je obejmują, więc nie możesz przypadkowo zrezygnować ze zwrotów, zachowując subskrypcje.

• Otrzymuj powiadomienia dla subskrypcji i wszystkich anulowanych zakupów. Otrzymujesz zdarzenia subskrypcji i każdy anulowany zakup, ale nie zdarzenia zakupu produktów jednorazowych.
• Otrzymuj wszystkie powiadomienia dla subskrypcji i produktów jednorazowych. Otrzymujesz powyższe plus zdarzenia produktów jednorazowych, takie jak ONE_TIME_PRODUCT_PURCHASED i ONE_TIME_PRODUCT_CANCELED.

Ile Cię to kosztuje, w pieniądzu

Anulowanie to strata już zaksięgowana, zanim powiadomienie do Ciebie dotrze. Cena sprzedaży przepadła, podobnie jak wszystko, co wydałeś na obsługę tego klienta. Jeśli generował obrazy, uruchamiał wywołania Twoich modeli, pobierał pamięć masową lub wyzwolił wypłatę na rzecz strony trzeciej, te koszty zostały opłacone prawdziwymi pieniędzmi i nie wracają wraz ze zwrotem. Powiadomienie nie może odzyskać żadnego z nich. Może natomiast zatrzymać krwawienie od tego momentu, co jest całym powodem, aby zadziałać na nie szybko.

Krwawienie jest najgorsze przy subskrypcjach i najgorsze przy obciążeniach zwrotnych. Subskrypcja, której nie odbierzesz, wciąż kosztuje Cię obsługę, miesiąc po miesiącu, dla klienta, który już nie płaci. A obciążenie zwrotne to najdroższy rodzaj anulowania. Od August 3, 2026 dokumentacja Google stwierdza, że obciążenie zwrotne przekazuje deweloperowi cenę zakupu wraz z opłatą banku. Powiadomienie o anulowanym zakupie często jest pierwszym miejscem, w którym Twoje własne systemy słyszą, że obciążenie zwrotne zostało zakończone, więc handler, który odbiera dostęp od razu, jest tym, co powstrzymuje utraconą sprzedaż przed przekształceniem się w utraconą sprzedaż plus tygodnie darmowej obsługi.

Jak obsłużyć powiadomienie o anulowanym zakupie, krok po kroku

Zweryfikuj i usuń duplikaty wiadomości

• Potwierdź, że wiadomość Pub/Sub pochodzi z Google i celuje w temat, który skonfigurowałeś, a następnie zdekoduj pole data z base64, aby uzyskać JSON DeveloperNotification.
• Użyj messageId Pub/Sub, aby odrzucać duplikaty. Google ostrzega, że to samo powiadomienie może zostać dostarczone więcej niż raz, więc traktuj powtórki jako normalne i uczyń swój handler idempotentnym.
• Potwierdź (acknowledge) wiadomość dopiero po bezpiecznym jej zapisaniu, aby awaria w trakcie działania handlera nie utraciła zdarzenia.

Odszukaj zakup

• Dopasuj purchaseToken do zakupu zapisanego przy pierwszym przyznaniu uprawnienia. W razie potrzeby posłuż się orderId do wyszukiwań wsparcia i ręcznego uzgadniania.
• Odczytaj productType, aby wybrać ścieżkę odbierania subskrypcji lub jednorazową, i odczytaj refundType, aby zdecydować między pełnym a częściowym odebraniem.

Odbierz i zapisz

• Usuń uprawnienie. Przy pełnym zwrocie odetnij dostęp do przedmiotu. Przy częściowym zwrocie opartym na ilości zmniejsz przyznaną ilość o kwotę zwróconą i pozostaw resztę nienaruszoną.
• Zapisz, co zrobiłeś i kiedy, kluczując według purchaseToken i orderId. Ten zapis pozwala Ci później odpowiedzieć na zgłoszenie wsparcia i pozwala Voided Purchases API czysto uzgadniać się z Twoim własnym stanem.

Gdzie mieści się wśród innych sygnałów zwrotu

Powiadomienie o anulowanym zakupie to zawiadomienie, a nie negocjacja. Mówi Ci o wyniku, który jest już przesądzony. Warto zobaczyć je obok sygnałów, z którymi łatwo je pomylić, bo tylko niektóre z nich w ogóle proszą o Twoją wersję historii.

Myśl, której trzeba się trzymać, jest prosta. W obu sklepach istnieją dokładnie dwa przepływy zwrotów, w których deweloper ma głos, CONSUMPTION_REQUEST Apple i przegląd obciążeń zwrotnych Google Play. Powiadomienie o anulowanym zakupie nie jest żadnym z nich. Zanim do Ciebie dotrze, decyzja jest już za Tobą, a jedyne, co pozostaje w Twoich rękach, to jak szybko odbierzesz dostęp.