Jede Verlängerung erhält eine eigene Google Play-Bestellnummer, und genau diese Nummer sollten Sie prüfen, bevor Sie jemandem etwas erstatten

Schauen Sie auf das Ende der Bestellnummer, bevor Sie einem Google Play-Kunden etwas erstatten. GPA.1234-5678-9012-34567 ist die erste Abbuchung eines Abos. GPA.1234-5678-9012-34567..2 ist die dritte. Sie haben dieselbe Basis, sind aber unterschiedliche Zahlungen, und die Play Console behandelt sie bei einer Erstattung unterschiedlich. Die Google Play-Bestellnummer ist die einzige Kennung, die Ihr Kunde sieht, also landet genau sie in Ihrem Support-Postfach. Lesen Sie sie richtig, dann erstatten Sie die Abbuchung, über die sich der Kunde tatsächlich ärgert, und zwar genau einmal.

Was eine Google Play-Bestellnummer verrät

Die Dokumentation der Play Billing Library von Google erklärt das Format anhand eines Beispiels. Eine Bestellnummer beginnt mit GPA, danach folgen Zifferngruppen. Bei Abos erhält jede Verlängerung die Basis-Bestellnummer plus zwei Punkte und einen Zähler, der bei null beginnt. Der ursprüngliche Kauf hat also kein Suffix, die erste Verlängerung ist ..0, die zweite ..1 und so weiter.

Am Suffix sehen Sie daher schnell, wie lange jemand schon zahlt. Ein Kunde, der wegen GPA.3333-4137-0319-36762..11 schreibt, wurde zwölfmal verlängert. Ein Kunde, der die reine Basisnummer nennt, hat entweder einmalig gekauft oder meint seine allererste Zahlung.

Wo die Bestellnummer auftaucht und welche Variante Sie bekommen

Hier stolpern viele Teams. Verschiedene Stellen liefern Ihnen unterschiedliche Formen derselben Nummer.

• Die Google Play-Quittung des Kunden zeigt die Bestellnummer der jeweiligen Abbuchung, auch bei Verlängerungen.
• In Ihrer App liefert Purchase.getOrderId() aus der Play Billing Library bei Abo-Verlängerungen die Bestellnummer der ursprünglichen Bestellung. Googles eigenes Beispiel: Statt GPA.1234-5678-9012-34567..0 erhalten Sie GPA.1234-5678-9012-34567.
• Auf Ihrem Server liefert purchases.subscriptionsv2 für jede Position ein latestSuccessfulOrderId, also die Nummer der letzten erfolgreichen Bestellung für diesen Artikel. Google hat das Feld am 21. Mai 2025 eingeführt.
• In der Voided Purchases API identifiziert orderId eindeutig einen Einmalkauf, einen Abo-Kauf oder eine Abo-Verlängerung. Laut Googles Dokumentation sollten Sie orderId und nicht das Kauftoken verwenden, um Verlängerungen zu unterscheiden.

Wofür stattdessen das Kauftoken da ist

Das Kauftoken (purchaseToken) identifiziert den Kauf als Ganzes. Bei einem Abo deckt ein einziges Token die ursprüngliche Abbuchung und jede spätere Verlängerung ab. Deshalb ist es der richtige Schlüssel für Berechtigungen und der falsche für eine Erstattung. Erstattungen und Rückbuchungen betreffen eine einzelne Abbuchung, und nur die Bestellnummer bezeichnet eine einzelne Abbuchung.

So finden Sie eine Google Play-Bestellung

In der Play Console

Die Bestellverwaltung (Order management) akzeptiert im Suchfeld entweder eine Bestellnummer oder die vollständige E-Mail-Adresse des Kunden. Jede Bestellung hat einen dieser Status: Verarbeitet (Processed), Storniert (Cancelled), Ausstehend (Pending), Erstattung ausstehend (Pending refund), Erstattet (Refunded), Teilerstattung ausstehend (Pending partial refund) oder Teilweise erstattet (Partially refunded). Nennt der Kunde statt einer Quittung eine E-Mail-Adresse, suchen Sie danach, wählen die Abbuchung anhand des Datums aus und prüfen dann das Suffix, bevor Sie handeln.

Mit der Orders API

Seit dem 21. Mai 2025 bietet die Orders-Ressource der Google Play Developer API orders.get für eine einzelne Bestellung und orders.batchget für eine Liste. In der Praxis zählen ein paar Grenzen:

• batchget nimmt pro Anfrage zwischen 1 und 1.000 Bestellnummern an, und sie müssen eindeutig sein.
• Wird auch nur eine Bestellnummer nicht gefunden oder gehört sie nicht zum Paket, schlägt die gesamte batchget-Anfrage fehl.
• Aufrufe der Orders API zählen gegen Ihr Kontingent für die Play Developer API, das standardmäßig bei 200.000 Aufrufen pro Tag liegt.

Die zurückgegebene Order ist der eigentlich nützliche Teil. Sie enthält den Status der Bestellung, ihr purchaseToken, createTime und lastEventTime, den Gesamtbetrag und die Steuer, einen salesChannel wie IN_APP oder PLAY_STORE sowie eine orderHistory mit den Ereignissen für Verarbeitung, Stornierung, Erstattung und Teilerstattung. Außerdem enthält sie developerRevenueInBuyerCurrency, laut Google Ihr Erlös in der Währung des Käufers, abzüglich Teilerstattungen, Steuern und Gebühren. Ist Google der Händler (Merchant of Record), enthält die Käuferadresse nur das Land.

Die richtige Bestellung erstatten

Sobald Sie wissen, welche Abbuchung der Kunde meint, bietet Ihnen die Play Console eine Wahl, die davon abhängt, wo diese Bestellung im Abo steht.

Über die API nimmt orders.refund den Paketnamen und die Bestellnummer entgegen. Bestellungen, die älter als 3 Jahre sind, können nicht erstattet werden. Der optionale Parameter revoke beendet, wenn er auf true gesetzt ist, den Zugriff auf das Abo oder den In-App-Artikel sofort. Die Google-Hilfe weist außerdem darauf hin, dass Erstattungen nach der Ausführung nicht rückgängig gemacht werden können. Die Bestellnummer, die Sie übergeben, ist also endgültig.

Warum taucht bei einem Abonnenten eine Bestellung über 0,00 $ auf?

Googles Dokumentation zum Abo-Lebenszyklus erklärt es. Wenn sich ein Nutzer in Ihrer App erneut für denselben Basis-Tarif anmeldet, bevor sein Abo abläuft, erstellt Google Play eine Bestellung über 0,00 $. Er zahlt nichts, weil er den aktuellen Zeitraum bereits bezahlt hat, und die normale Abrechnung läuft zum ursprünglichen Verlängerungsdatum weiter. Es handelt sich weder um ein kostenloses Probeabo noch um eine Aktion. Bei dieser Bestellung gibt es nichts zu erstatten. Will der Kunde Geld zurück, suchen Sie die bezahlte Bestellung davor.

Was Sie eine Erstattung der falschen Bestellung kostet

Eine Erstattung gibt den Preis zurück. Teilerstattungen funktionieren anteilig genauso. Googles Beispiel: Eine Teilerstattung von 50 % nimmt auch 50 % Ihrer Auszahlung und 50 % der Servicegebühr zurück. Nicht zurück kommt alles, was Sie für diesen Kunden ausgegeben haben, also Rechenleistung, Aufrufe externer APIs, Speicher und etwaige Partnerprovisionen. Erstatten Sie die falsche Bestellung, zahlen Sie das doppelt.

So passiert es. Ein Kunde mit Monatsabo schreibt wegen der Abbuchung ..4 von letzter Woche. Jemand in Ihrem Team sucht nach der E-Mail-Adresse, sieht die erste Bestellung oben in der Liste und klickt bei der Basisbestellung von vor Monaten auf „Nur erstatten“. Der Kunde bekommt nun Geld für einen Zeitraum zurück, den er genutzt hat. Die Abbuchung, über die er sich beschwert hat, bleibt unberührt, und sein Abo verlängert sich weiter. Er kann seine Bank immer noch bitten, die Abbuchung von letzter Woche zurückzubuchen.

Dieser Weg über die Bank ist inzwischen der teure. Für Bestellungen ab dem 3. August 2026 gilt laut Google: Wenn eine Rückbuchung durchgeht, haftet der Entwickler für den Kaufpreis abzüglich der Play-Servicegebühr, zuzüglich der Rückbuchungsgebühren der Bank. Rückbuchungen sind bei der Bank endgültig. Ein falsch gelesenes Suffix kann so mit dem Geld von zwei Erstattungen plus Gebühren enden.

Welche Erstattungen Ihr Postfach nie erreichen

Die meisten Google Play-Erstattungen brauchen weder Sie noch die Bestellnummer. Laut Googles Erstattungsrichtlinie kann ein Kunde innerhalb von 48 Stunden nach dem Kauf über Google Play eine Erstattung erhalten und soll sich nach 48 Stunden an den Entwickler wenden. Google erstattet und widerruft außerdem Abos, die Sie nicht innerhalb von drei Tagen bestätigen. Davon erfahren Sie im Nachhinein über die Voided Purchases API, die die voidedSource (0 für User, 1 für Developer, 2 für Google) und einen voidedReason wie Remorse, Chargeback oder Unacknowledged_purchase meldet.

Nur ein einziger Erstattungsablauf bei Google Play fragt nach Ihrer Sicht. Wenn eine Rückbuchung eine Prüfung durch den Entwickler erfordert, haben Sie 24 Stunden Zeit, über orders.reviewrefund mit einer Erstattungspräferenz von APPROVE, DECLINE oder NEUTRAL und Nachweisen zur Nutzung des Kaufs zu antworten. RefundHalt beantwortet diese Prüfung für Sie innerhalb der Frist und nutzt dafür die Nutzungsdaten, die Sie bereits haben. So bekommt eine strittige Bestellung Ihre Nachweise statt Schweigen.

Eine kurze Checkliste für Support-Tickets mit Bestellnummer

• Fragen Sie nach der vollständigen Bestellnummer von der Google Play-Quittung, inklusive Suffix.
• Suchen Sie sie in der Play Console oder mit orders.get und prüfen Sie zuerst den Status.
• Prüfen Sie, ob das Datum der Abbuchung zu der Schilderung des Kunden passt.
• Verwenden Sie „Erstatten und widerrufen“ nur bei der jüngsten Bestellung und „Nur erstatten“ bei älteren.
• Notieren Sie die erstattete Bestellnummer, damit eine spätere Rückbuchung zu einer anderen Bestellung leicht auffällt.