Eine Benachrichtigung über einen stornierten Kauf lässt Ihren Google Play-Server den Zugriff in dem Moment entziehen, in dem eine Rückerstattung eintrifft

Eine Rückerstattung bei Google Play muss nichts sein, das Sie später in einem Bericht entdecken. Google Play kann Ihrem Server in dem Augenblick eine Benachrichtigung über einen stornierten Kauf senden, in dem ein Kauf storniert wird, ob der Käufer eine Selbstbedienungs-Rückerstattung vorgenommen hat, ein Support-Mitarbeiter eine gewährt hat, eine Bank eine Rückbuchung erzwungen hat oder Sie die Bestellung selbst mit gesetztem Widerrufs-Flag erstattet haben. Die Nachricht ist winzig, sie nennt den exakten Kauf und sie trägt eine Anweisung, das Nutzungsrecht zurückzunehmen, weil das Geld bereits weg ist.

Was eine Benachrichtigung über einen stornierten Kauf tatsächlich ist

Eine Benachrichtigung über einen stornierten Kauf ist ein Typ von Google Plays Real-time Developer Notifications, oder RTDN. RTDN ist ein Push-Kanal. Google veröffentlicht eine Nachricht in einem Cloud Pub/Sub-Topic, das Ihnen gehört, und Ihr Backend empfängt sie innerhalb von Augenblicken nach dem Ereignis, statt es bei Ihrer nächsten planmäßigen Abfrage zu erfahren. Das ist der ganze Sinn der Benachrichtigung über einen stornierten Kauf gegenüber dem älteren Pull-Weg: Sie erfahren von der Rückerstattung, während sie geschieht, nicht Stunden später.

Der Pull-Weg existiert weiterhin und ist weiterhin wichtig. Die Voided Purchases API erlaubt Ihrem Server, nach Ihrem eigenen Zeitplan die Liste der Käufe abzufragen, die in einem Zeitraum storniert wurden. Die beiden ergänzen sich. Die Benachrichtigung teilt Ihnen den Augenblick mit, in dem ein Kauf umschlägt; die API erlaubt Ihnen, in großem Umfang abzugleichen und alles nachzutragen, was eine verpasste Nachricht zurückgelassen hätte.

Sie reist innerhalb einer Real-time Developer Notification

Die Benachrichtigung über einen stornierten Kauf trifft niemals allein ein. Sie sitzt in einer DeveloperNotification-Hülle, und diese Hülle wird als einzelne base64-codierte Zeichenkette im Feld data der Pub/Sub-Nachricht geliefert. Ihr Handler decodiert diese Zeichenkette zu JSON, bevor er irgendetwas lesen kann. Die Hülle nennt stets die App und den Ereigniszeitpunkt und sie enthält genau ein Benachrichtigungsobjekt aus den fünf, die Google definiert. Sie schließen sich gegenseitig aus, daher wird eine Nachricht, die ein voidedPurchaseNotification trägt, nicht auch ein Abonnement- oder Einmalkauf-Ereignis tragen.

Die vier Felder, die sie trägt

Nehmen Sie die Hülle weg, und die Benachrichtigung über einen stornierten Kauf selbst besteht aus vier Feldern. Das ist bewusst sparsam. Googles Standpunkt ist, dass diese vier ausreichen, wenn Sie nur den richtigen Kauf finden und das Nutzungsrecht anpassen müssen, und Sie keine API zurückrufen müssen, um zu handeln.

productType sagt Ihnen, was storniert wurde

productType ist eine kleine Ganzzahl, und sie entscheidet, welchen Ihrer Widerrufswege Sie nehmen. Eine Abonnement-Stornierung muss laufenden Zugriff rückabwickeln; eine Einmalkauf-Stornierung entfernt nur ein einzelnes Nutzungsrecht.

refundType sagt Ihnen, wie viel zurückkam

refundType trennt eine saubere vollständige Rückabwicklung von einer teilweisen. Der Teilfall ist eng. Er tritt nur auf, wenn bei einem Einmalkauf mit mehreren Einheiten ein Teil, aber nicht die gesamte Menge, erstattet wurde.

Schalten Sie sie zuerst ein, sonst kommt sie nie an

Benachrichtigungen über stornierte Käufe fließen nicht standardmäßig. Sie aktivieren RTDN einmal in der Play Console und richten sie auf ein Pub/Sub-Topic, das Sie kontrollieren. Der Schalter befindet sich unter Monetize, dann Monetization setup, im Abschnitt Real-time developer notifications oben auf der Seite. Aktivieren Sie Enable real-time notifications, fügen Sie dann Ihren vollständigen Topic-Namen in der Form projects/{project_id}/topics/{topic_name} ein und verwenden Sie Send Test Message, um zu bestätigen, dass die Leitung funktioniert, bevor Sie ihr vertrauen.

Der Inhaltsschalter ist die Stelle, an der Leute stornierte Käufe verpassen. Beide Optionen schließen sie ein, sodass Sie sich nicht versehentlich von Rückerstattungen abmelden können, während Sie Abonnements behalten.

• Get notifications for subscriptions and all voided purchases. Sie erhalten Abonnement-Ereignisse und jeden stornierten Kauf, aber keine Kaufereignisse für Einmalprodukte.
• Get all notifications for subscriptions and one-time products. Sie erhalten das Obige plus Einmalprodukt-Ereignisse wie ONE_TIME_PRODUCT_PURCHASED und ONE_TIME_PRODUCT_CANCELED.

Was es Sie kostet, in Geld

Eine Stornierung ist ein Verlust, der bereits verbucht ist, wenn die Benachrichtigung Sie erreicht. Der Verkaufspreis ist weg, und ebenso alles, was Sie für die Bedienung dieses Kunden ausgegeben haben. Wenn er Bilder generiert, Aufrufe gegen Ihre Modelle ausgeführt, Speicher bezogen oder eine Auszahlung an einen Dritten ausgelöst hat, wurden diese Kosten mit echtem Geld bezahlt und kommen mit der Rückerstattung nicht zurück. Die Benachrichtigung kann nichts davon zurückholen. Was sie tun kann, ist, die Blutung von hier an zu stoppen, was der ganze Grund ist, schnell darauf zu reagieren.

Die Blutung ist am schlimmsten bei Abonnements und am schlimmsten bei Rückbuchungen. Ein Abonnement, das Sie nicht entziehen, kostet Sie weiterhin in der Bedienung, Monat für Monat, für einen Kunden, der nicht mehr zahlt. Und eine Rückbuchung ist die teuerste Art der Stornierung. Ab dem August 3, 2026 besagt Googles Dokumentation, dass eine Rückbuchung den Kaufpreis plus die Gebühr der Bank an den Entwickler weitergibt. Die Benachrichtigung über einen stornierten Kauf ist häufig die erste Stelle, an der Ihre eigenen Systeme hören, dass eine Rückbuchung abgeschlossen ist, daher ist ein Handler, der auf der Stelle entzieht, das, was einen verlorenen Verkauf davon abhält, sich in einen verlorenen Verkauf plus Wochen kostenlosen Dienstes zu verwandeln.

Wie Sie eine Benachrichtigung über einen stornierten Kauf behandeln, Schritt für Schritt

Verifizieren und deduplizieren Sie die Nachricht

• Bestätigen Sie, dass die Pub/Sub-Nachricht von Google stammt und auf das von Ihnen konfigurierte Topic zielt, und decodieren Sie dann das base64-Feld data, um das DeveloperNotification-JSON zu erhalten.
• Verwenden Sie die Pub/Sub-messageId, um Duplikate zu verwerfen. Google warnt, dass dieselbe Benachrichtigung mehr als einmal zugestellt werden kann, behandeln Sie eine erneute Zustellung also als normal und machen Sie Ihren Handler idempotent.
• Bestätigen Sie die Nachricht erst, nachdem Sie sie sicher aufgezeichnet haben, damit ein Absturz mitten im Handler das Ereignis nicht verliert.

Schlagen Sie den Kauf nach

• Gleichen Sie den purchaseToken mit dem Kauf ab, den Sie gespeichert haben, als Sie das Nutzungsrecht zum ersten Mal gewährt haben. Greifen Sie für Support-Nachschläge und den manuellen Abgleich auf die orderId zurück.
• Lesen Sie productType, um den Widerrufsweg für Abonnement oder Einmalkauf zu wählen, und lesen Sie refundType, um zwischen einem vollständigen und einem teilweisen Widerruf zu entscheiden.

Entziehen und aufzeichnen

• Entfernen Sie das Nutzungsrecht. Bei einer vollständigen Rückerstattung kappen Sie den Zugriff auf den Artikel. Bei einer mengenbasierten Teilrückerstattung reduzieren Sie die gewährte Menge um den erstatteten Betrag und lassen den Rest unangetastet.
• Halten Sie fest, was Sie getan haben und wann, mit purchaseToken und orderId als Schlüssel. Dieser Datensatz ist es, der Ihnen später erlaubt, ein Support-Ticket zu beantworten, und der es der Voided Purchases API erlaubt, sauber gegen Ihren eigenen Zustand abzugleichen.

Wo sie unter den anderen Rückerstattungssignalen steht

Eine Benachrichtigung über einen stornierten Kauf ist eine Mitteilung, keine Verhandlung. Sie teilt Ihnen ein Ergebnis mit, das bereits entschieden ist. Es lohnt sich, sie neben den Signalen zu sehen, mit denen sie leicht zu verwechseln ist, denn nur einige von ihnen bitten überhaupt um Ihre Version der Geschichte.

Der Leitsatz, an dem man festhalten sollte, ist einfach. Über beide Stores hinweg gibt es genau zwei Rückerstattungsabläufe, bei denen der Entwickler ein Mitspracherecht hat, Apples CONSUMPTION_REQUEST und Google Plays Rückbuchungsprüfung. Eine Benachrichtigung über einen stornierten Kauf ist keines von beiden. Wenn sie Sie erreicht, liegt die Entscheidung hinter Ihnen, und das Einzige, was Ihnen bleibt, ist, wie schnell Sie entziehen.