Die Chargeback-Prüfung von Google Play gibt dir 24 Stunden zum Kontern, das solltest du senden

Wenn die Bank eines Kunden eine Google-Play-Zahlung zurückbucht, erstattet Google Play das Geld nicht einfach und macht weiter. Es sendet eine PendingRefundReviewNotification an deinen Server und startet eine 24-Stunden-Uhr. Beantworte diese Benachrichtigung über die ReviewRefund API mit einer Erstattungspräferenz und Nachweisen darüber, was der Kunde tatsächlich genutzt hat, und Google Play bezieht deine Angaben in die Anfechtung des Chargebacks ein. Schweigst du, wird der Streitfall ohne ein Wort der einzigen Partei entschieden, die weiß, wie das Produkt verbraucht wurde.

Die Google-Play-Chargeback-Prüfung ist der einzige Android-Erstattungsablauf, der dich nach Nachweisen fragt, das direkte Gegenstück zu Apples CONSUMPTION_REQUEST. Sie ist jetzt wichtiger als früher. Ab dem 3. August 2026 verlagert Google Play die Kosten von Chargebacks auf die Entwickler, ein Streitfall, den du nicht beantwortest, geht also zu deinen Lasten, nicht zu Googles. Hier steht genau, was die Benachrichtigung enthält, was du zurücksendest, welche Felder deine Nachweise ausmachen und wo das Schweigen zu Geld wird.

Was eine Google-Play-Chargeback-Prüfung wirklich ist

Ein Chargeback ist keine Erstattungsanfrage. Der Kunde wendet sich an seine Bank oder sein Kartennetzwerk und beanstandet die Zahlung, und die Bank bucht die Gelder zurück. Google Play wickelt die meisten davon selbst ab. Bei einem Teil öffnet es eine Prüfung und fragt zuerst dich, weil du Informationen hast, die Google nicht hat: ob die Bestellung geliefert wurde und wie viel davon der Kunde verbraucht hat. Diese Prüfung ist der Ablauf hinter der ReviewRefund API.

Dies ist die eine Stelle im Android-Erstattungssystem, an der deine Nachweise das Ergebnis verändern. Jeder andere Google-Play-Erstattungsweg läuft ohne dich. Ein Kunde kann innerhalb von 48 Stunden nach dem Kauf eine Erstattung selbst auslösen, der Support kann eine gewähren, und ein nicht bestätigter Kauf wird automatisch erstattet, alles von Google entschieden. Die Chargeback-Prüfung ist die Ausnahme, und es lohnt sich, sie als das einzige Erstattungsgespräch zu behandeln, an dem du wirklich teilnehmen kannst.

Es ist die Android-Version von Apples Nachweisfenster

Zwei Stores, zwei Abläufe, die einen Entwickler nach Nachweisen fragen, und das ist die ganze Liste. Apple sendet einen CONSUMPTION_REQUEST und gibt dir 12 Stunden, um mit Send Consumption Information zu antworten. Google Play sendet eine PendingRefundReviewNotification und gibt dir 24 Stunden, um mit orders.reviewrefund zu antworten. Die Mechanik unterscheidet sich, aber die Lehre ist identisch: Wenn der Store fragt, was der Kunde genutzt hat, ist eine präzise Antwort der Unterschied zwischen dem Behalten des Verkaufs und seiner Rückgabe.

Ein Unterschied zählt in der Praxis. Apples Verbrauchsdaten bestehen aus fünf numerischen Feldern und sonst nichts. Die Nachweise von Google Play sind reichhaltiger. Du kannst einen Verbrauchsprozentsatz plus eine Liste einzelner Nutzungsereignisse senden, jedes mit einem Zeitstempel, einer Kontokennung und sogar einer IP-Adresse und einer groben location. Google Play gibt dir mehr Raum, die Lieferung zu beschreiben, was mehr Raum bedeutet, überzeugend zu sein.

Die 24-Stunden-Uhr und wie die Benachrichtigung dich erreicht

Die Prüfung kommt als Real Time Developer Notification über dein Cloud Pub/Sub-Topic an, denselben Kanal, der deine Abonnement- und Kaufereignisse liefert. Die Nachricht ist eine base64-codierte Nutzlast mit einem pendingRefundReviewNotification-Objekt darin. Die Uhr startet, wenn diese Benachrichtigung veröffentlicht wird, nicht wenn du sie zufällig liest, ein Consumer, der einmal am Tag abfragt, ist also ein Consumer, der Streitfälle verpasst.

PendingRefundReviewNotification, Feld für Feld

Die Benachrichtigung ist klein. Sie sagt dir, welche Bestellung geprüft wird, übergibt dir das Token, das du zurückgeben musst, und nennt den Grund. Hier ist jedes Feld, das sie enthält.

Nur ein Chargeback öffnet eine ausstehende Prüfung

Der refundReason bei einer ausstehenden Prüfung ist immer CHARGEBACK, geliefert als die Ganzzahl 7. In der Welt von Google Play gibt es weitere Erstattungsgründe, aber sie erreichen dich nicht über diesen Ablauf, weil du bei ihnen kein Mitspracherecht hast. Wenn du eine PendingRefundReviewNotification siehst, hat eine Bank eine Zahlung rückgängig gemacht, und Google Play entscheidet, ob es sie anficht. Das ist der einzige Auslöser.

Was du über die ReviewRefund API zurücksendest

Du antwortest mit einem einzigen POST an orders.reviewrefund. Der vollständige Pfad ist POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/orders/{orderId}:reviewrefund, autorisiert mit dem Scope https://www.googleapis.com/auth/androidpublisher, demselben OAuth-Scope, den deine Play Developer API-Integration bereits verwendet. Ein Erfolg liefert einen leeren Body mit HTTP 200 zurück.

Im Body lebt dein Fall. Du gibst das pendingRefundToken aus der Benachrichtigung zurück, gibst eine Erstattungspräferenz an und fügst Verbrauchsnachweise bei.

Deine Erstattungspräferenz ist eine Empfehlung, kein Urteil

Das Feld refundPreference nimmt einen von drei Werten an, und es ist ein Rat an Google Play, keine endgültige Entscheidung. Google behält das Ergebnis in der Hand. Aber es ist ein Rat, gestützt auf Daten, die Google allein nicht sehen kann, also fällt er ins Gewicht.

Die Nachweisfelder, die ein DECLINE untermauern

Ein bloßes DECLINE ist eine Behauptung ohne Beweis. Die Verbrauchsfelder sind der Beweis. consumptionPercentageMilliunits ist eine Ganzzahl in Milli-Einheiten, 100000 sagt also, dass der Kunde 100 Prozent des Gekauften verbraucht hat, und 50000 sagt die Hälfte. consumptionUsageEvents ist ein optionales Array, in dem jedes Ereignis eine obfuscatedAccountId, eine obfuscatedProfileId, eine consumptionTime, eine ipAddress, eine consumptionItemDescription und eine grobe location tragen kann. sampleContentProvided ist ein boolescher Wert für den Fall, dass du dem Kunden eine kostenlose Probe des bezahlten Inhalts gegeben hast. Zusammen sagen sie, in Google Plays eigenem Schema, dass das Produkt geliefert und genutzt wurde.

Dein erster Aufruf ist dein einziger Aufruf

Google Play erfasst den ersten ReviewRefund-Aufruf, den du zu einer Benachrichtigung machst, und ignoriert jeden Aufruf danach, liefert dabei aber weiterhin einen OK-Status zurück. Es gibt keinen Entwurf und keine Überarbeitung. Wenn deine erste Antwort ein hastiges NEUTRAL ohne Nachweise ist, weil deine Pipeline nicht bereit war, ist das die aktenkundige Antwort, und der spätere Aufruf mit der vollständigen Verbrauchshistorie wird stillschweigend verworfen. Baue die vollständige Antwort auf, bevor du irgendetwas sendest.

Was dich die Prüfung an Geld kostet

Jahrelang kostete ein verlorener Google-Play-Chargeback den Entwickler den Verkauf und wenig mehr, weil Google Play die nachgelagerten Gebühren übernahm. Das endet am 3. August 2026. Für Bestellungen nach diesem Datum teilt Google Play die Chargeback-Kosten mit den Entwicklern, und der Anteil des Entwicklers ist der Kaufpreis abzüglich der Play-Servicegebühr, plus die zugehörige Chargeback-Gebühr, die vom Finanzinstitut erhoben wird. Google Play übernimmt weiterhin den Servicegebührenanteil. Die Bankgebühr ist neues Gewicht auf deiner Seite der Bilanz.

Die Erstattung ist nie die tatsächliche Zahl

Der Streitfall gibt die Zahlung des Kunden zurück, aber die Zahlung war nie deine einzigen Kosten. Ein generiertes Video, ein Stapel Modell-API-Aufrufe, eine Creator-Auszahlung, von dir bereitgestellter Speicher, all dieses Geld verließ dein Konto in dem Moment, in dem die Bestellung geliefert wurde, und nichts davon kommt mit dem Chargeback zurück. Nun kommt die Chargeback-Gebühr der Bank obendrauf. Du zahlst die Anbieterrechnung, erstattest den Verkauf und deckst die Streitgebühr, drei Kosten für eine Bestellung, für die du die Nachweise zur Verteidigung hattest.

Das Ausmaß, das Google bekämpft

Google Play gibt an, 2025 US$3.4B an Betrug und Missbrauch blockiert zu haben und baut bis 2026 die Betrugserkennung aus. Die Änderung der Kostenteilung gehört zum selben Vorstoß: Entwicklern einen Grund geben, Nachweise in das System einzuspeisen, und das System ficht mehr der unrechtmäßigen Streitfälle an. Die ReviewRefund API ist der Weg, wie deine Nachweise hineingelangen. Eine leere Antwort ist eine Stimme dafür, einen Friendly-Fraud-Chargeback auf deine Kosten bestehen zu lassen.

Wie du bereit bist, bevor die Benachrichtigung eintrifft

Das 24-Stunden-Fenster ist nicht das Problem. Das Problem ist, dass die Nachweise, die du brauchst, vor dem Streitfall existieren müssen, erfasst zum Kauf- und Verbrauchszeitpunkt, nicht rekonstruiert, nachdem ein Token auftaucht. Ein Team, das erst mit dem Sammeln von Daten beginnt, wenn die Benachrichtigung eintrifft, hat bereits verloren.

Verknüpfe die Identität beim Kauf

Setze bei jedem Kauf eine obfuscatedAccountId mit setObfuscatedAccountId, damit die Konto-ID der Benachrichtigung direkt einem Nutzer in deinem System zugeordnet wird. Halte sie als Hash, 64 Zeichen oder weniger, niemals als Klartext-E-Mail oder andere personenbezogene Daten, denn Klartext-Kennungen führen dazu, dass Käufe blockiert werden. Ohne diese Verknüpfung kannst du das pendingRefundToken nicht mit einer echten Nutzungshistorie verbinden, und dein DECLINE hat nichts dahinter.

Protokolliere den Verbrauch, während er geschieht

Erfasse, was eine bezahlte Bestellung geliefert hat, wann und an wen, in einer Form, die du bei Bedarf in consumptionPercentageMilliunits und consumptionUsageEvents umwandeln kannst.

• Versieh jede Verbrauchseinheit mit einem Zeitstempel, damit consumptionTime bei jedem Ereignis echt ist, nicht geschätzt.
• Verfolge die Lieferung gegen den Kauf, damit du einen Verbrauchsprozentsatz mit Sicherheit angeben kannst, statt zu raten.
• Halte die Konto- und Profilkennungen neben der Nutzung, damit sich ein Ereignis in einer einzigen Abfrage zusammensetzt, wenn das Token eintrifft.
• Erfasse die Anfrage-IP und die grobe location, falls du sie hast, da Google Play beide als Ereignisfelder akzeptiert.

Antworte innerhalb des Fensters, automatisch

Ein 24-Stunden-Fenster ist für eine Maschine bequem und für einen Menschen, der wach und aufmerksam sein muss, brutal. Die Antwort sollte automatisch sein: Benachrichtigung rein, Konto nachgeschlagen, Verbrauch zusammengestellt, ein ReviewRefund-Aufruf raus, alles ohne einen Menschen in der Schleife. Das ist der Teil, den RefundHalt für dich übernimmt. Wir warten auf die PendingRefundReviewNotification, ordnen die Bestellung der Nutzung zu, die wir für dieses Konto bereits verfolgen, und beantworten orders.reviewrefund innerhalb des Fensters mit einer Erstattungspräferenz und echten Verbrauchsnachweisen. Das Token ist der Faden, und die Nachweise sind der Fall. Halte beides bereit, und das eine Erstattungsgespräch, an dem du teilnehmen darfst, ist eines, das du gewinnen kannst.