Lesen Sie den Erstattungsgrundcode, den Ihr Server ohnehin schon erhält, und er sagt Ihnen, ob Sie Ihre App reparieren oder mit dem Kunden streiten sollten

Wenn Apple oder Google einem Ihrer Kunden Geld erstattet, ist das Geld meist weg, bevor Sie eine Stimme haben. Was danach auf Ihrem Server landet, sieht aus wie eine Quittung, und die meisten Teams behandeln es auch so. Es ist mehr als das. Jede Erstattung trägt einen Erstattungsgrundcode, und er ist der einzige Teil einer Erstattung, den Sie noch lesen dürfen, nachdem die Entscheidung gefallen ist. Google Play sagt Ihnen, dass die Erstattung eine Rückbuchung war, oder eine Reue-Anfrage, oder ein Kauf, den Ihre eigene App nie bestätigt hat. Apple sagt Ihnen, ob die Erstattung etwas in Ihrer App beschuldigt hat. Lesen Sie diesen Code, und eine Erstattung ist keine Zeile in einem Bericht mehr, sondern eine Anweisung: reparieren Sie dies, bestreiten Sie dies, oder lassen Sie diese eine ziehen. Hier steht, was jeder Code bedeutet, wie Sie sie triagieren, und was jeder kostet.

Was ein Erstattungsgrundcode tatsächlich ist

Ein Erstattungsgrundcode ist das eigene Etikett des Stores dafür, warum ein Kauf rückgängig gemacht wurde. Sie legen ihn nicht fest und können nicht mit ihm streiten. Er kommt im Nachhinein an die Erstattung angehängt, und die beiden Stores stellen ihn in unterschiedlichen Formen und mit sehr unterschiedlicher Auflösung dar.

Google Play stempelt einen Grund und eine Quelle auf jede Stornierung

Die Voided Purchases API von Google Play liefert einen Datensatz pro rückgängig gemachtem Kauf, und jeder Datensatz trägt zwei ganze Zahlen, die zählen. Der voidedReason sagt, warum der Kauf storniert wurde. Der voidedSource sagt, wer es in Gang gesetzt hat. Zusammen verwandeln sie eine nackte Erstattung in einen Satz: diese Bestellung wurde wegen einer Rückbuchung storniert, ausgelöst von Google, oder aus Reue storniert, ausgelöst vom Nutzer. Sie lesen dies, indem Sie die API abfragen oder die Echtzeit-Entwicklerbenachrichtigung abonnieren, die auslöst, wenn eine Stornierung eintrifft. So oder so sind die beiden Zahlen die Nutzlast, die es wert ist, aufbewahrt zu werden.

Apple gibt Ihnen ein engeres Signal, aber ein scharfes

Apple reicht Ihnen keinen Grund mit neun Möglichkeiten. Bei einer erstatteten Transaktion setzt Apple den revocationReason auf einen von zwei Werten. Eine 1 bedeutet, dass der App Store die Transaktion wegen eines tatsächlichen oder vermeintlichen Problems in Ihrer App erstattet hat. Eine 0 bedeutet, dass er aus einem anderen Grund erstattet hat, zum Beispiel einem versehentlichen Kauf. Das Feld erscheint nur bei Transaktionen, die erstattet oder widerrufen wurden, neben einem revocationDate, innerhalb der signierten Transaktionsinformationen der REFUND App Store Server Notification. Zwei Werte sind nicht viel, aber der, der zählt, eine 1, ist Apple, das Ihnen sagt, dass die Erstattung um Ihr Produkt ging, nicht um die zweiten Gedanken des Kunden.

Die neun Gründe, die Google Play Ihnen gibt

Googles voidedReason ist der reichhaltigere der beiden, und jeder Wert ist es wert, auf einen Blick gekannt zu werden, weil jeder woanders hinweist. Hier ist der vollständige Satz, direkt aus der VoidedPurchase-Ressource, mit dem, was jeder Code Ihnen tatsächlich zu tun sagt.

voidedSource sagt Ihnen, wer abgedrückt hat

Neben dem Grund steht der voidedSource, und er beantwortet eine andere Frage: wer dies rückgängig gemacht hat. Eine 0 bedeutet, der Nutzer hat es getan, per Selbstbedienung oder über eine Bank. Eine 1 bedeutet, der Entwickler hat es getan, also Sie oder Ihre eigenen Werkzeuge, die eine Erstattung ausstellen. Eine 2 bedeutet, Google hat es getan, nach eigenem Ermessen, einschließlich der automatischen Erstattung für einen unbestätigten Kauf. Wenn Sie eine Spitze an Stornierungen sehen, ist die Quelle der erste Schnitt. Eine Wand aus Quelle 2 ist Google, das auf Ihrem Konto handelt, und das ist gewöhnlich ein Signal, das auf Ihre Integration zurückweist statt auf Ihre Kunden.

Sortieren Sie jede Erstattung in reparieren, bestreiten oder akzeptieren

Der Grund, warum ein Code nützlich ist, liegt darin, dass er Ihnen sagt, welche von drei Antworten eine Erstattung verdient. Die meisten Teams behandeln alle Erstattungen gleich und verbrennen Mühe an denen, die sie nie gewinnen können. Die Codes teilen sich sauber.

Reparieren: die Erstattungen, die Ihr Produkt verursacht hat

Manche Codes sind Fehlerberichte im Gewand einer Erstattung. Defekt (3) und nicht erhalten (2) bei Google, und ein revocationReason von 1 bei Apple, sagen alle dasselbe: der Kunde hat bezahlt und Ihre App hat nicht geliefert. Unbestätigter Kauf (8) ist der schärfste davon, weil die Schuld vollständig in Ihrem Abrechnungscode liegt. Das sind die günstigsten Erstattungen zum Beseitigen, weil Sie sie beseitigen, indem Sie etwas reparieren, das Ihnen gehört, nicht indem Sie jemanden überzeugen. Eine steigende Zahl in diesem Stapel ist ein Produktfehler mit einem angehängten Geldbetrag.

Bestreiten: die Erstattungen, an denen jemand arbeitet

Betrug (5), freundlicher Betrug (6) und Rückbuchung (7) sind die Streitfälle. Reiner Betrug (5) ist nicht Ihr Kunde und kein Umsatz, den Sie je behalten hätten. Freundlicher Betrug (6), bei dem der Käufer genau das bekam, wofür er bezahlt hat, und es dann bestritt, ist der eine Streitfall, den Ihre Belege noch bewegen können, und die Rückbuchung (7) ist dort, wo diese Belege eingereicht werden. Wenn einer davon eintrifft, entziehen Sie den Zugang, falls noch nicht geschehen, und wo ein Prüffenster offen ist, beantworten Sie es mit dem, was Sie über das Konto wissen.

Akzeptieren: die Erstattungen, die zu stoppen nie Ihre Sache war

Reue (1) und versehentlicher Kauf (4) sind die eigene Meinungsänderung des Kunden. Apples revocationReason von 0 gehört auch hierher. Keine Funktion ist ausgefallen und kein Betrug ist geschehen. Sie können den Eimer der versehentlichen Käufe mit einer klareren Kaufbestätigung mildern, aber Sie können eine Reue-Erstattung nicht wegargumentieren, und die Zeit, die Sie damit verbringen, ist Zeit, die dem Reparatur-Stapel genommen wird, wo das Geld tatsächlich liegt.

Der 30-Tage-Haken, der Grundcodes leicht verlierbar macht

Es gibt eine harte Grenze auf Googles Seite, die dies von einer Berichtsfunktion in eine Frist verwandelt. Wenn Sie die Codes nicht fortlaufend erfassen, verlieren Sie sie.

Die Voided Purchases API blickt nur 30 Tage zurück

Google ist eindeutig: die API kann nur stornierte Käufe der letzten 30 Tage zeigen. Ältere Stornierungen werden nicht zurückgegeben, egal welchen startTime Sie übergeben, und der startTime-Wert selbst kann nicht früher als 30 Tage zurück gesetzt werden. Schlimmer für eine naive Integration ist, dass das 30-Tage-Fenster danach gemessen wird, wann Googles Systeme einen Kauf als storniert sehen, nicht danach, wann der Kauf getätigt wurde oder auch nur nach dem voidedTimeMillis im Datensatz. So ist ein Erstattungsgrundcode, den Sie nicht innerhalb dieses Fensters abrufen, weg, und ein monatlicher Exportlauf mit irgendeiner Lücke lässt stillschweigend Stornierungen fallen, die er zu langsam war zu erfassen.

Was die Grundcodes in Geld wert sind

Zwei Codes tragen einen bestimmten Preis, und sie zu lesen ist die Art, wie Sie eine Zahl an Probleme heften, die sich sonst in einer aggregierten Erstattungsquote verstecken.

Ein Code ist eine Rechnung, die Sie sich selbst geschrieben haben

voidedReason 8, unbestätigter Kauf, ist das sauberste Beispiel für eine Erstattung, die Sie verursacht haben. Google Play verlangt, dass Ihre App einen Kauf innerhalb von drei Tagen nach Gewährung des Anspruchs bestätigt, und wenn Sie das nicht tun, erstattet Google die Bestellung automatisch und widerruft den Artikel. Jede mit 8 gestempelte Stornierung ist ein echter Verkauf, von einem Kunden, der das Produkt wollte, zurückgegeben, weil ein Aufruf zur Bestätigung des Kaufs nie ausgelöst hat. Der verlorene Betrag ist der volle Verkaufspreis plus die Rechenleistung, API-Aufrufe und den Speicher, die Sie bereits für die Lieferung ausgegeben haben. Das ist keine Erstattung, über die Sie verhandeln. Es ist ein Fehler, den Sie schließen, und der Code ist die Art, wie Sie ihn finden.

Der Rückbuchungscode trägt jetzt eine Gebühr

voidedReason 7, Rückbuchung, hat am 3. August 2026 die Kosten geändert. Für Google-Play-Bestellungen, die an diesem Datum oder danach aufgegeben werden, kostet eine verlorene Rückbuchung den Entwickler den Kaufpreis abzüglich der Servicegebühr von Play, plus die Rückbuchungsgebühr der Bank, während Google nur seine eigene Servicegebühr deckt. Da Rückbuchungsgebühren pauschal sind und Produktpreise nicht, kann bei einem günstigen In-App-Kauf allein die Gebühr das übersteigen, was der Kunde bezahlt hat. Ihre Stornierungen mit Code 7 zu zählen bedeutet jetzt, einen Kostenposten zu zählen, nicht nur einen verlorenen Verkauf, was genau der Grund ist, warum der Rückbuchungs-Eimer eine eigene Zeile in jedem Erstattungsbericht verdient, den Sie erstellen.

Wie Apple und Google sich zueinander verhalten

Die beiden Stores beantworten dieselbe Frage in unterschiedlicher Auflösung, sodass ein storeübergreifender Erstattungsbericht sie normalisieren muss, statt zu erwarten, dass sie übereinstimmen.

Die Stores werden Ihnen nie denselben Code für dieselbe Erstattung geben, und das ist in Ordnung. Was zählt, ist, dass beide Ihnen einen maschinenlesbaren Grund reichen, und beide ein Team belohnen, das ihn liest. Apples einzelnes Bit sagt Ihnen, wann eine Erstattung die Schuld Ihres Produkts ist. Googles neun Gründe und sein Quellen-Flag sagen Ihnen, welchen Produktfehler, welchen Streitfall und welche selbst verschuldete Abrechnungslücke Sie vor sich haben. Kein Code stoppt eine Erstattung. Beide sagen Ihnen, was zu tun ist, damit die nächste nicht geschieht.

RefundHalt erfasst den Grundcode bei jeder Erstattung in dem Moment, in dem sie eintrifft, auf beiden Stores, und hält ihn gut innerhalb von Googles 30-Tage-Fenster, damit nichts entwischt. Es sortiert jede Stornierung in reparieren, bestreiten oder akzeptieren, sodass eine Spitze bei Code 3 defekt Sie als Produktwarnung erreicht und eine Spitze bei Code 8 unbestätigt Sie als Integrationsfehler erreicht, nicht als vager Umsatzrückgang. Es beantwortet Apples CONSUMPTION_REQUEST innerhalb von 12 Stunden und Google Plays Rückbuchungsprüfung innerhalb von 24, und es entzieht den Zugang in dem Moment, in dem eine Erstattung oder Rückbuchung eintrifft. Sie können den Code, den ein Store auf eine Erstattung stempelt, nicht ändern. Sie können sicherstellen, dass Sie jeden lesen und bei denen handeln, die tatsächlich Ihre sind, um sie zu reparieren.