Die App Store Order ID auf dem Beleg eines Kunden zeigt dir, was er gekauft hat und ob Apple es schon erstattet hat

Bevor du auf die Erstattungs-Mail eines iPhone-Kunden antwortest, frag nach der App Store Order ID auf seinem Apple-Beleg. Diese eine Zeichenfolge, durch Apples Endpunkt Look Up Order ID geschickt, sagt dir, welches Produkt er gekauft hat, wann, und ob Apple es schon erstattet hat. Ohne sie gleichst du einen Screenshot und eine E-Mail-Adresse mit deiner Datenbank ab und hoffst. Mit ihr weißt du in Sekunden, ob du mit einem zahlenden Kunden sprichst, mit einem Kunden, dem Apple das Geld schon zurückgezahlt hat, oder mit jemandem, der einen Beleg aus einer anderen App in der Hand hält.

Woher die App Store Order ID kommt

Apples Dokumentation ist eindeutig. Wenn Kunden einen oder mehrere In-App-Käufe in deiner App tätigen, schickt der App Store ihnen einen Beleg per E-Mail, und dieser Beleg enthält eine Order ID. Kunden finden ihre Order IDs auch in ihrem Kaufverlauf im App Store. Apples Kaufverlauf liegt auf reportaproblem.apple.com und in der App Store App unter Apps & Kaufverlauf, und er zeigt standardmäßig die letzten 90 Tage, mit Filtern für ältere Käufe.

Der Kunde hat den Schlüssel also schon. Dein Support-Formular muss nur danach fragen.

Warum eine E-Mail-Adresse nicht reicht

Apple gibt dir die E-Mail-Adresse des Apple Accounts nicht weiter. Die Adresse, die an deinen Support schreibt, hat vielleicht nichts mit dem Account zu tun, der bezahlt hat. Wenn du beim Kauf ein appAccountToken setzt, kannst du eine Transaktion deiner eigenen Nutzer-ID zuordnen, aber nur von deiner Seite aus. Die Order ID funktioniert von der Seite des Kunden, über einen Beleg, den er mit einem Tippen weiterleiten kann.

Was Look Up Order ID zurückgibt

Look Up Order ID gehört zur App Store Server API und ist ab Version 1.1.0 verfügbar. Du rufst GET https://api.storekit.apple.com/inApps/v1/lookup/{orderId} mit deinem signierten JWT auf. Laut Apple basiert die Antwort auf dem In-App-Kaufverlauf des Kunden, unabhängig davon, ob er die App installiert, gelöscht oder neu installiert hat.

Ist der Beleg für meine App gültig?

Genau diese Frage beantwortet OrderLookupStatus zuerst. Eine 1 bedeutet, dass die Order ID zu keinen Käufen in deiner App passt. Die üblichen Fälle sind ein Tippfehler, ein Beleg für eine andere App oder ein Beleg, der gar nicht aus dem App Store stammt. Bei einer 1 nichts erstatten, gutschreiben oder wiederherstellen. Bitte den Kunden, den Beleg noch einmal zu prüfen.

Hat Apple diesen Kauf schon erstattet?

Prüf revocationDate in jeder dekodierten Transaktion. Ist es gesetzt, hat Apple den Kauf schon erstattet oder aus der Familienfreigabe entzogen, und der Kunde hat sein Geld. Deine App Store Server Notifications sollten für dieselbe Transaktion ein REFUND geschickt haben, also ist das auch ein günstiger Weg, um zu bestätigen, dass dein Server den Zugang wirklich entzogen hat.

Was die Order ID im App Store nicht kann

Sie kann keine Erstattung auslösen. Entwickler haben keinen Erstattungsknopf im App Store. Apple entscheidet über Erstattungen, und Apples Support-Artikel schickt Kunden zu reportaproblem.apple.com, wo sie „Ich möchte“ wählen, dann „Rückerstattung anfordern“, einen Grund angeben und den Artikel auswählen. Apple sagt außerdem, dass eine ausstehende Belastung erst erstattet werden kann, wenn der Kunde den Beleg per E-Mail hat.

Mitreden darfst du nur beim CONSUMPTION_REQUEST von Apple. Wenn ein Kunde Apple um eine Erstattung bittet, kann Apple diese Benachrichtigung schicken, und du hast 12 Stunden, um mit Send Consumption Information zu antworten. Die Abfrage der Order ID ist ein Support-Werkzeug. Sie öffnet dieses Zeitfenster nicht und verlängert es auch nicht.

Was eine Erstattungs-Mail kostet, wenn du die Abfrage auslässt

Support ohne Order ID ist die Stelle, an der still Geld versickert. Drei Muster tauchen immer wieder auf.

• Kulanz zusätzlich zur Erstattung. Apple erstattet den Kauf, der Kunde schreibt auch dir, und der Support vergibt Gratis-Credits oder einen Extra-Monat. Jeder Credit, den du verschenkst, läuft auf Rechenleistung, API-Aufrufen und Speicher, die du bezahlst, und das auf einem Account, der sein Geld schon zurückhat.
• Zugang, der nie entzogen wurde. Wenn deine REFUND-Verarbeitung fehlgeschlagen ist, erzeugt der erstattete Kunde weiter Nutzung. Eine Abfrage, die ein revocationDate zeigt, während deine Datenbank noch aktiv sagt, ist ein Fehlerbericht mit Preisschild.
• Falscher Account, falsche Lösung. Wenn du den Account hinter einer weitergeleiteten E-Mail wiederherstellst oder ihm etwas gutschreibst, obwohl die Order ID jemand anderem gehört, bekommt eine Person bezahlten Service, die nie etwas gekauft hat.

Keines dieser Muster braucht eine Rückbuchung oder eine Frist, um wehzutun. Es sind einfach Support-Antworten ohne Fakten. Ein API-Aufruf pro Ticket beendet das Raten.

Heißt revocationReason 1, dass ich etwas falsch gemacht habe?

Nicht unbedingt. Laut Apple bedeutet Grund 1, dass Apple den Kauf wegen eines tatsächlichen oder vermuteten Problems in deiner App erstattet hat. Das Wort vermutet trägt dabei viel. Aber eine Häufung von Erstattungen mit Grund 1 bei einem Produkt, nach einem Release, ist das deutlichste Produkt-Feedback, das Apple dir gibt. Zähl sie.

Wie sich die Order ID von Google Play unterscheidet

Google Play funktioniert andersherum. Laut Googles Billing-Dokumentation bekommen Nutzer eine E-Mail mit einer eindeutigen Order ID für jeden einmaligen Produktkauf, für den ersten Abo-Kauf und für jede wiederkehrende Verlängerung, und du kannst die Order ID nutzen, um Erstattungen in der Play Console zu verwalten. Du durchsuchst die Bestellverwaltung nach Order ID oder nach der vollständigen E-Mail-Adresse des Nutzers und erstattest dann selbst.

Bei Google Play zählt die Order ID mehr, weil du selbst den Knopf drückst. Laut Play Console entfernt die Erstattung der neuesten Abo-Bestellung das Abo sofort und storniert künftige Verlängerungen, während die Erstattung einer älteren Bestellung nur eine Erstattung ist und das Abo aktiv lässt. Teilerstattungen gibt es nur für Bestellungen ab März 2018, und eine kostenpflichtige App kannst du nicht teilweise erstatten.

Stell die Order ID an den Anfang deines Erstattungs-Supports

• Frag in deinem Support-Formular nach der Order ID, mit einem Hinweis in einer Zeile: Sie steht in der Beleg-E-Mail von Apple oder Google Play.
• Ruf unter iOS Look Up Order ID auf, dekodiere jede Transaktion und zeig dem Support productId, purchaseDate, revocationDate und revocationReason auf einem Bildschirm.
• Ist OrderLookupStatus 1, halt an und frag nach dem richtigen Beleg. Gewähr nichts.
• Ist revocationDate gesetzt, bestätige, dass der Zugang auf deinem Server schon entzogen ist, und schließ dann das Ticket. Keine Kulanz obendrauf.
• Ist es nicht gesetzt und der Kunde will sein Geld zurück, schick ihn zu reportaproblem.apple.com und halte deinen CONSUMPTION_REQUEST Handler für das 12-Stunden-Fenster bereit. RefundHalt beantwortet diese Anfrage mit den Verbrauchsdaten, die Apple verlangt.
• Unter Android such die genaue Bestellung in der Play Console, bevor du erstattest, und entscheide bewusst zwischen reiner Erstattung und Erstattung mit Entzug.