Zakup oczekujący wygląda jak sprzedaż, ale pieniądze jeszcze nie dotarły, a udostępnienie go zbyt wcześnie oznacza oddanie produktu za darmo

Ktoś stuka w Twojej aplikacji przycisk kup. Twoje logi pokazują nowe zamówienie, Twój listener rozliczeń się uruchamia, a Ty wydajesz towar. W przypadku większości zakupów to dokładnie to, co trzeba. W przypadku zakupu oczekującego to błąd, bo zamówienie istnieje, ale pieniądze nie. Klient wybrał metodę płatności, która rozlicza się później, sklep wciąż czeka na zapłatę, a Ty właśnie dostarczyłeś płatną funkcję za obciążenie, które może nigdy nie wpłynąć. To cichy krewny zwrotu. Tutaj nic nie zostaje cofnięte, bo nic nigdy nie zostało pobrane. Po prostu oddałeś produkt za darmo.

Zakup oczekujący to prawdziwe zamówienie w stanie jeszcze-nieopłaconym i mają go zarówno App Store, jak i Google Play. Oba sklepy wyraźnie mówią, żeby czekać. Pułapka polega na tym, że zamówienie oczekujące w Twoim kodzie wygląda niemal identycznie jak zakończone, więc integracja, która traktuje każdy nowy zakup jako sprzedaż, wydaje towar na zamówienia, które sklep wciąż próbuje pobrać. Zrób to poprawnie, a nic nie stracisz. Zrób to źle, a każda powolna płatność, która przepada, to czysty koszt, dostarczony na Twój rachunek.

Czym właściwie jest zakup oczekujący

Zakup oczekujący to zamówienie, które sklep zarejestrował, ale za które jeszcze nie pobrał opłaty. Kupujący rozpoczął proces, sklep go przyjął, a rozliczenie odbywa się gdzieś, gdzie Twoja aplikacja nie widzi. Google Play nazywa to stanem PENDING. Apple nazywa to transakcją oczekującą lub odroczoną. Różne nazwy, ten sam fakt: sklep trzyma zamówienie otwarte, czekając na zapłatę, i powiedział Ci, żeby nie traktować tego zamówienia jak pieniędzy.

Google Play: płatność dzieje się gdzie indziej

Niektóre metody płatności rozliczają się poza głównym obiegiem. Gotówka w fizycznym sklepie, przelewy bankowe i niektóre płatności przez rachunek telefoniczny wymagają dodatkowych kroków między stuknięciem a obciążeniem. Gdy klient wybierze jedną z nich, Google zwraca zakup w stanie PENDING zamiast PURCHASED. Przy płatności gotówką klient otrzymuje kod przez powiadomienie i e-mail, zanosi go do uczestniczącego sklepu i płaci w kasie. Dopóki to się nie stanie, Google nic nie pobrało, i Ty również. Reguła Google to jedno zdanie: użyj getPurchaseState() i przyznaj uprawnienie tylko wtedy, gdy stan to PURCHASED. Google mówi też, żeby nie potwierdzać zakupu, dopóki jest PENDING, bo potwierdzenie należy się zamówieniu opłaconemu, a nie obiecanemu.

Apple: zakup czeka na czyjeś stuknięcie

Oczekujący stan Apple oznacza, że transakcja potrzebuje działania zewnętrznego, zanim będzie mogła się zakończyć. Najczęstsze to Ask to Buy, gdzie dziecko rozpoczyna zakup, a organizator rodziny musi go zatwierdzić. W StoreKit 2 wywołanie zakupu zwraca Product.PurchaseResult.pending. W starszym StoreKit transakcja jest zgłaszana jako odroczona. Tak czy inaczej Apple nikogo nie obciążył, a zakończona transakcja, jeśli nadejdzie, dociera asynchronicznie przez Transaction.updates. Pokaż klientowi stan oczekiwania i nie odblokowuj niczego, dopóki nie wpłynie zakończona transakcja.

Dlaczego udostępnienie zakupu oczekującego kosztuje Cię prawdziwe pieniądze

Strata tutaj nie jest tego rodzaju co zwrot, gdzie zaksięgowane pieniądze zostają wycofane. Jest gorsza w jeden konkretny sposób: nie ma pieniędzy do wycofania, bo nigdy żadnych nie pobrano.

Dostarczasz, a sklep nigdy nic nie pobiera

Gdy odblokujesz przy zamówieniu oczekującym, które później zostanie anulowane, już poniosłeś wydatek na jego obsługę. Moc obliczeniowa, która uruchomiła funkcję, opłacone wywołania API zewnętrznych dostawców, przydzielona pamięć, a w przypadku produktu zużywalnego rzeczywista wypłata sprzedanej rzeczy. Wszystko to wychodzi za drzwi na zamówieniu, które nie przyniosło przychodu. Zwrot zaczyna się przynajmniej od obciążenia, które nastąpiło. Błędnie przyznany zakup oczekujący nigdy nie miał żadnego obciążenia, więc nawet nie pojawia się jako wychodzące pieniądze. Pojawia się jako nic, i właśnie dlatego łatwo go przeoczyć i łatwo powtórzyć.

Sygnał anulowania i co oznacza

Sklep faktycznie informuje Cię, gdy zamówienie oczekujące umiera. W Google Play produkt jednorazowy, który przepada, wysyła powiadomienie ONE_TIME_PRODUCT_CANCELED, typ 2, a subskrypcja, która była oczekująca, wysyła SUBSCRIPTION_PENDING_PURCHASE_CANCELED, typ 20. Gdy te same zamówienia zamiast tego przechodzą, otrzymujesz ONE_TIME_PRODUCT_PURCHASED, typ 1, lub SUBSCRIPTION_PURCHASED, typ 4. W Apple nie ma zdarzenia anulowania do przechwycenia, bo transakcja odroczona, która zostaje odrzucona, po prostu nigdy nie staje się zakończoną transakcją. Jeśli odblokowałeś zbyt wcześnie, ta cisza to rachunek.

Okno czasowe i kto na kogo czeka

Zakup oczekujący to nie zegar, z którym się ścigasz. To zegar, który z Twojej strony jeszcze nie ruszył.

Google Play daje klientowi dni, nie minuty

Płatność gotówką lub przelewem bankowym rozlicza się według harmonogramu klienta, nie Twojego. Zamówienie tkwi w PENDING, dopóki klient nie zapłaci albo okno nie upłynie i Google go nie anuluje. Twoje własne trzydniowe okno potwierdzenia, to, które automatycznie zwraca zakup, którego nie potwierdzisz, nawet się nie zaczyna, dopóki zakup nie przejdzie z PENDING do PURCHASED. Nie ma więc pośpiechu, żeby obsłużyć zamówienie oczekujące. Jest tylko dyscyplina, żeby czekać na zmianę stanu.

Zatwierdzenie Apple jest na telefonie organizatora rodziny

Prośba Ask to Buy trafia na urządzenie organizatora jako monit, który zatwierdza lub odrzuca, kiedy się do tego zabierze. To może być minuty, godziny lub dzień później, a Twoja aplikacja nie może tego przyspieszyć. Jedyne poprawne zachowanie to odzwierciedlenie stanu oczekiwania i pozwolenie, by StoreKit przekazał Ci zakończoną transakcję, jeśli i kiedy nadejdzie zatwierdzenie.

Jak obsługiwać zakupy oczekujące bez strat

Całe zadanie sprowadza się do czterech nawyków. Żaden z nich nie jest trudny, a pominięcie choćby jednego to miejsce, gdzie znikają pieniądze.

Przyznawaj przy stanie opłaconym, nigdy przy oczekującym

W Google Play sprawdzaj getPurchaseState() i przyznawaj tylko przy PURCHASED, i nie potwierdzaj zakupu, dopóki jest PENDING. W Apple odblokowuj tylko przy zakończonej transakcji i nigdy przy wyniku oczekującym. Ta jedna reguła zamyka cały wyciek. Cała reszta polega na upewnieniu się, że faktycznie zauważysz, gdy nadejdzie stan opłacony.

Sprawdzaj ponownie, gdy aplikacja wraca

Przejście z oczekiwania do opłacenia często dzieje się, gdy Twoja aplikacja nie działa. W Google Play wywołaj queryPurchasesAsync() w swoim handlerze onResume(), aby wychwycić zamówienia, które w tle stały się PURCHASED, i utrzymuj swój listener Real-time Developer Notifications jako serwerowe źródło prawdy. W Apple nasłuchuj Transaction.updates przez całe życie aplikacji, bo zatwierdzona transakcja może nadejść długo po tym, jak pierwotne wywołanie zakupu zwróciło wynik.

Włącz obsługę oczekujących i przetestuj oba zakończenia

Google wymaga wywołania enablePendingPurchases() przy tworzeniu BillingClient, a obsługa transakcji oczekujących dla produktów jednorazowych jest obowiązkowa, nie opcjonalna. Przetestuj to, zanim wdrożysz. Testerzy licencyjni otrzymują dwa dodatkowe instrumenty testowe dla opóźnionych form płatności, gdzie płatność automatycznie się kończy lub automatycznie anuluje po kilku minutach, więc możesz obserwować zarówno ścieżkę zapłaty, jak i ścieżkę przepadnięcia od początku do końca.

Powiedz klientowi, że zamówienie nie jest ukończone

Kupujący oczekujący to prawdziwy klient w środku zakupu, nie porażka. Pokaż mu, że zamówienie czeka na jego płatność lub na zatwierdzenie, i daj mu jasną drogę powrotu, by je dokończyć. Cichy stan oczekiwania traci sprzedaże, które dobrze oznaczony odzyskuje, bo większość tych kupujących wciąż chce tej rzeczy i został im tylko jeden krok.

Te same kanały Real-time Developer Notifications i App Store Server Notifications, które RefundHalt już czyta dla zwrotów i obciążeń zwrotnych, niosą też te sygnały. Powiadomienie purchased mówiące, że zamówienie oczekujące w końcu wpłynęło, i powiadomienie canceled mówiące, że nie, lądują w Twoim panelu obok reszty zdarzeń przychodowych, więc zamówienie oczekujące, które przepadło, to coś, co możesz zobaczyć, a nie coś, za co przypadkiem zapłaciłeś.

Wersja skrócona

Zakup oczekujący to zamówienie bez płatności i oba sklepy jasno mówią, że powinieneś czekać. Google Play zwraca zamówienia gotówkowe, przelewem bankowym i niektóre przez rachunek telefoniczny w stanie PENDING i mówi, żeby przyznawać dostęp tylko przy PURCHASED. Apple zwraca transakcję oczekującą lub odroczoną dla Ask to Buy i innych wymaganych działań i dostarcza zakończoną transakcję później przez Transaction.updates. Odblokowuj przy stanie opłaconym, sprawdzaj ponownie, gdy Twoja aplikacja się wznawia, włącz i przetestuj obsługę oczekujących oraz oznacz oczekujące zamówienie dla klienta. Zrób to, a zakup oczekujący nic Cię nie kosztuje. Pomiń to, a dostarczysz płatny produkt za obciążenie, które nigdy nie nadeszło, co jest jedyną stratą bez paragonu, na który można wskazać.