Apple Send Consumption Information prosi teraz o pięć pól, a nie dwanaście, i oto każde z nich

Lista faktów, o które Apple Cię prosi, gdy klient chce zwrotu, znacznie się skróciła. Ładunek Send Consumption Information, jedyna odpowiedź, jaką deweloper może wprowadzić do decyzji o zwrocie w App Store, miał wcześniej dwanaście pól. Teraz ma pięć. Apple skróciło go w okolicach WWDC24 i złożyło większość starych pytań o profilowanie konta w dwa proste pytania i jedną liczbę. Mniej pól to nie drobna zmiana. Zmienia to, jakie dowody Apple waży, i zmienia to, w których polach nie możesz sobie pozwolić na błąd.

Oto dlaczego zasługuje to na Twoją uwagę, a nie jest tylko notatką o schemacie. Ten ładunek to jedyny moment w zwrocie Apple, w którym Twoja wersja historii dociera do decyzji. Zwrot za zakup konsumpcyjny cofa przychód, który już wydałeś realne pieniądze, aby dostarczyć, a pięć pól to sposób, w jaki mówisz Apple, że produkt został dostarczony i wykorzystany. Przegap 12-godzinne okno albo wypełnij pole błędnie, a Apple rozstrzygnie wyłącznie na podstawie roszczenia klienta.

Czym jest Send Consumption Information

Send Consumption Information to punkt końcowy App Store Server API, który wywołujesz po tym, jak Apple wyśle na Twój serwer powiadomienie CONSUMPTION_REQUEST. To powiadomienie oznacza, że klient poprosił Apple o zwrot za zakup w aplikacji, a Apple chce Twojego wkładu, zanim zdecyduje. Odpowiadasz, wysyłając małe ciało JSON, ConsumptionRequest, metodą PUT do punktu końcowego. Apple je czyta, waży wobec historii klienta i podejmuje decyzję. Nigdy nie decydujesz o zwrocie. Dostarczasz fakty.

Ciało to cały interfejs. Nie ma osobnego formularza, odwołania ani drugiego zgłoszenia, które się liczy. Cokolwiek wyślesz w tym jednym ładunku, jest Twoją całą sprawą, więc znaczenie każdego pola waży więcej, niż sugeruje liczba pól.

Pięć pól, o które Apple teraz prosi

Bieżący ConsumptionRequest ma pięć członków. Trzy są wymagane, a dwa opcjonalne. Wszystko, o co Apple pytało wcześniej odnośnie konta klienta, jego staż, jego łączne wydatki, jego łączne zwroty, jego czas gry, zostało usunięte z tego, co wysyłasz.

customerConsented to bramka

customerConsented to Boolean i jest to pole, które decyduje, czy w ogóle cokolwiek wysyłasz. Rejestruje, czy klient zgodził się, abyś udostępnił Apple dane o zużyciu. Wytyczne Apple są jednoznaczne: jeśli klient nie wyraził zgody, nie wysyłaj informacji o zużyciu. To zatem nie jest pole, które przełączasz na true, aby wzmocnić swoją sprawę. Odzwierciedla realne tak lub nie, które musisz już posiadać, a false tutaj oznacza, że reszta ładunku nie powinna być wysyłana.

deliveryStatus to pole, które porusza zwroty

deliveryStatus to enum typu String i jest to najsilniejsza dźwignia, jaką masz. Mówi Apple, czy Twoja aplikacja faktycznie dostarczyła działający zakup w aplikacji. Jedna wartość mówi tak. Pozostałe cztery mówią nie, każda z innego powodu, i każda mówi Apple, że klient ma uzasadnioną skargę.

sampleContentProvided odpowiada na pytanie o uczciwość

sampleContentProvided to Boolean. Rejestruje, czy dałeś klientowi darmową próbkę, wersję próbną lub jasne informacje o tym, co robi zakup, zanim go kupił. True tutaj to mały sygnał uczciwości: klient miał szansę wiedzieć, co kupuje. Samo w sobie niczego nie rozstrzyga, ale jest jednym z zaledwie trzech wymaganych pól, więc Apple wyraźnie chce je mieć w każdej odpowiedzi.

consumptionPercentage to teraz liczba, a nie status

To pole, które zmieniło się najbardziej. Stary ładunek miał consumptionStatus, czterostopniowy enum: UNDECLARED, NOT_CONSUMED, PARTIALLY_CONSUMED, FULLY_CONSUMED. Nowy ładunek zastępuje go przez consumptionPercentage, liczbę całkowitą mierzoną w milliunits. 100,000 milliunits oznacza, że element został w pełni zużyty, więc 50,000 to połowa, a 0 to nietknięty. Precyzyjna liczba bije podział na cztery kubełki, bo pozwala powiedzieć, że klient wykorzystał 90 procent pakietu kredytów, zamiast zaokrąglać w dół do częściowo zużytego.

Jedno zastrzeżenie, na którym ludzie się potykają. W przypadku subskrypcji odnawialnych automatycznie Apple samo ustala zużycie na podstawie upływu czasu, więc consumptionPercentage jest przeznaczone dla zakupów konsumpcyjnych i nieodnawialnych. Wysyłaj je tam, gdzie ma zastosowanie, a tam, gdzie nie ma, pozwól Apple je wyprowadzić.

refundPreference wyraża preferencję, a nie werdykt

refundPreference to opcjonalny ciąg znaków i to tutaj mówisz Apple, jaki wynik byś wolał. Ono również zmieniło formę. Stare pole było liczbą z wartościami takimi jak prefer-grant, prefer-decline i no-preference. Nowe to nazwany ciąg znaków z trzema wartościami.

Co Apple porzuciło i dlaczego to ma znaczenie

Stary ConsumptionRequest miał dwanaście pól. Siedem z nich zniknęło z tego, co wysyłasz. accountTenure, lifetimeDollarsPurchased, lifetimeDollarsRefunded, playTime, userStatus, platform i appAccountToken były profilującą konto połową ładunku, polami, które prosiły Cię o zaszufladkowanie klienta według tego, jak długo miał konto, ile wydał, ile mu zwrócono i jak długo używał aplikacji.

Apple wycięło je z powodu wartego odnotowania. Te pola prosiły deweloperów o przekazanie profilu klienta, a większość deweloperów albo zostawiała je niezadeklarowane, albo zgadywała. Pięć, które pozostaje, dotyczy zakupu i dostarczenia, faktów, które faktycznie możesz zweryfikować z własnych systemów. Przesunięcie następuje od tego, kim jest klient, do tego, co stało się z tym konkretnym zakupem.

Punkt końcowy i zegar

Ładunek wysyłasz metodą HTTP PUT do punktu końcowego Send Consumption Information, adresowanego identyfikatorem transakcji spornego zakupu: PUT /inApps/v1/transactions/consumption/{transactionId}. Sukces zwraca 202 Accepted, a ciało odpowiedzi jest puste. Ta pusta odpowiedź jest oczekiwana, a nie błędem. Potwierdza, że Apple umieściło Twoje dane w kolejce, i nic nie mówi o ostatecznym wyniku, który przychodzi później jako powiadomienie REFUND lub REFUND_DECLINED.

Zegar to część, której nie rozciągniesz. Apple daje Ci 12 godzin od CONSUMPTION_REQUEST na odpowiedź. Używana jest tylko Twoja pierwsza odpowiedź, więc pierwszy ładunek musi być tym kompletnym i poprawnym. Apple może wysłać CONSUMPTION_REQUEST więcej niż raz dla tego samego zakupu, ale termin każdego z nich jest stały, a ręczna weryfikacja rzadko mieści się w 12 godzinach ponad strefami czasowymi i weekendami.

Ile kosztuje Cię źle obsłużone pole

Pieniądze opuściły budynek, zanim zrobił to zwrot

Zwrot za zakup konsumpcyjny nie jest czystym cofnięciem. Zanim klient poprosi o zwrot pieniędzy za pakiet kredytów lub partię generacji AI, już wydałeś na dostarczenie: inferencja GPU przy każdym żądaniu, wywołania API modeli zewnętrznych rozliczane za token, przechowywanie tego, cokolwiek wyprodukowałeś, i każda wypłata dla twórcy lub partnera powiązana z tym użyciem. Cena ze sklepu wraca do klienta. Twoje koszty dostarczenia nie wracają do Ciebie. Zwrot, który mogłeś zakwestionować, nie jest więc zdarzeniem bez zysku i straty, jest stratą netto wszystkiego, co zapłaciłeś, aby obsłużyć konto.

Pięć pól to sposób, w jaki unikasz płacenia dwa razy

deliveryStatus ustawione na DELIVERED i wysokie consumptionPercentage to dwa fakty, które mówią Apple, że klient otrzymał i wykorzystał produkt. Są Twoim dowodem, że moc obliczeniowa, wywołania API i przechowywanie wykonały swoją pracę. Zostaw ładunek niewysłany, a Apple nigdy tego nie usłyszy. Decyduje na podstawie roszczenia klienta, zwrot łatwiej przechodzi, a Ty ponosisz zarówno cofnięty przychód, jak i stojące za nim koszty dostarczenia.

Chargebacki to gorsze drzwi, a milczenie ku nim wskazuje

Klient, który nie uzyska satysfakcji przez proces zwrotów Apple, wciąż może zakwestionować obciążenie u swojego banku. Chargeback z karty jest ostateczny, niesie stałą opłatę za spór i zabiera decyzję z rąk Apple oraz Twoich. Dobra odpowiedź na CONSUMPTION_REQUEST utrzymuje spór wewnątrz systemu Apple, gdzie masz głos. Jego ignorowanie popycha przypadki graniczne ku jedynemu kanałowi, w którym głosu nie masz.

Jak radzi sobie z tym RefundHalt

Pięć pól wygląda prosto, dopóki nie musisz wypełnić ich poprawnie, w ciągu 12 godzin, przy każdym CONSUMPTION_REQUEST, przypisanych do właściwej transakcji. RefundHalt przechwytuje powiadomienie, odczytuje Twoje własne zapisy dostarczenia i użycia dla tego zakupu i wysyła ładunek automatycznie, zanim okno się zamknie. deliveryStatus odzwierciedla to, co faktycznie pokazują Twoje logi, consumptionPercentage pochodzi z rzeczywistego użycia, a nie z domysłu, a refundPreference podąża za polityką, którą ustawiasz raz. Otrzymujesz zakwestionowany zwrot rozpatrzony z dowodami, a nie przegapiony termin i decyzję podjętą bez Ciebie.