Kurze Antwort: Eine CONSUMPTION_REQUEST ist die Benachrichtigung, die Apple an Ihren Server sendet, wenn ein Kunde eine Rückerstattung für einen berechtigten In-App-Kauf oder ein Abonnement beantragt. Um darauf zu antworten, senden Sie eine strukturierte ConsumptionRequest zurück – eine Reihe von Feldern, die beschreiben, wie der Kunde das Gekaufte genutzt hat, ob er eingewilligt hat und welche Rückerstattungspräferenz Sie haben. Apple bezieht diese Felder in seine Entscheidung ein. Dieser Leitfaden erklärt, was jedes Feld bedeutet und warum es wichtig ist.
Was die Benachrichtigung ist
Wenn ein Kunde Apple um eine Rückerstattung bittet, sendet der App Store über App Store Server Notifications eine CONSUMPTION_REQUEST an Ihren Server. Apple sagt damit im Grunde: Teilen Sie uns mit, was Sie darüber wissen, wie dieser Kunde diesen Kauf genutzt hat, und wir beziehen es in unsere Entscheidung ein.
Sie antworten, indem Sie einen ConsumptionRequest-Body zurücksenden. Jeder Wert ist ein Signal. Senden Sie genaue, vollständige Apple-Rückerstattungsdaten, hat Apple Kontext; lassen Sie Felder leer, entscheidet Apple mit weniger Grundlage. Sie selbst genehmigen oder lehnen die Rückerstattung nicht ab – Apple trifft immer die endgültige Entscheidung –, aber die Qualität dessen, was Sie senden, beeinflusst die Erfolgschancen. Den vollständigen Ablauf finden Sie unter So automatisieren Sie Apple-Rückerstattungsanfragen.
Die Felder, die Apple akzeptiert
Hier erfahren Sie, was in eine ConsumptionRequest einfließt und was jedes Feld Apple mitteilt. Diese Consumption-Request-Felder liefern die strukturierten Daten, die im Consumption-API-Workflow verwendet werden:
Feld | Was es darstellt | Warum es wichtig ist |
customerConsented | Ob der Kunde der Weitergabe dieser Daten zugestimmt hat | Erforderlich. Muss „true" sein, sonst verarbeitet Apple die Antwort nicht. |
consumptionStatus | Nicht genutzt / teilweise genutzt / vollständig genutzt | Ein vollständig genutzter Kauf ist ein ganz anderer Fall als ein ungenutzter. |
deliveryStatus | Ob der Wert oder die Leistung erfolgreich zugestellt wurde | Unterscheidet „wir haben geliefert, der Kunde hat es genutzt" von einem echten Zustellungsfehler. |
refundPreference | Ihre Empfehlung: nicht angegeben / Rückerstattung befürwortet / Rückerstattung abgelehnt | Einer der Faktoren für Apple – wo Ihre Belege dies stützen, ist dies Ihre Stimme in der Entscheidung. |
accountTenure | Wie lange der Kunde bereits ein Konto bei Ihnen hat | Ein langjähriges Konto wird anders bewertet als ein brandneues. |
playTime | Wie viel Zeit der Kunde in Ihrer App verbracht hat | Direkter Beleg für die Nutzung dessen, wofür die Rückerstattung beantragt wird. |
lifetimeDollarsPurchased | Gesamtbetrag, den der Kunde in Ihren Apps ausgegeben hat | Kontext dazu, ob es sich um einen Einzelfall oder einen wertvollen Stammkunden handelt. |
lifetimeDollarsRefunded | Gesamtbetrag, der diesem Kunden bereits zuvor erstattet wurde | Ein Muster wiederholter Rückerstattungen ist ein aussagekräftiges Signal. |
sampleContentProvided | Ob der Kunde vor dem Kauf testen konnte | Gibt Aufschluss darüber, ob der Kauf informiert erfolgte. |
userStatus | Aktueller Kontostatus (aktiv, gesperrt usw.) | Zeigt den Status des Kunden zum Zeitpunkt der Anfrage. |
Apple ordnet die meisten dieser Felder definierten Wertesätzen zu (consumptionStatus und deliveryStatus verwenden beispielsweise bestimmte enumerierte Codes). Die genauen Codes finden Sie in Apples Dokumentation, die unten verlinkt ist, und sie können sich ändern – ein Grund, warum eine aktuelle Antwort laufende Arbeit erfordert und kein einmaliges Projekt ist.
Die drei wichtigsten Felder
Wenn Sie sich auf etwas konzentrieren sollten, dann hierauf:
customerConsented: Das ist nicht nur wichtig, sondern eine Voraussetzung. Apple lehnt die gesamte Übermittlung ab, wenn dieser Wert nicht „true" ist, und Sie sind rechtlich dafür verantwortlich, diese Einwilligung in Ihrer App eingeholt zu haben, bevor Sie überhaupt Daten senden. Es ist ebenso sehr ein Compliance-Feld wie ein technisches. Die Einwilligungspflicht behandeln wir ausführlich unter Kundeneinwilligung & die Consumption API.
refundPreference: Das kommt einer Abstimmung am nächsten, die Sie haben. Wo Ihre Belege eine Ablehnung tatsächlich stützen, ist die Angabe dieser Präferenz einer der Faktoren, die Apple berücksichtigt. Wo das nicht der Fall ist, ist eine erzwungene Ablehnungspräferenz kein magisches Überstimmungsrecht – Apple entscheidet trotzdem.
consumptionStatus: Ob der Kunde das Gekaufte tatsächlich genutzt hat, ist oft der Kern des Falls. Es ist auch eines der Felder, bei denen am leichtesten Fehler passieren, wenn Ihre Nutzungsdaten im Moment des Eingangs der Anfrage nicht genau und aktuell sind.
Warum das korrekte Ausfüllen schwieriger ist, als es aussieht
Beim Lesen einer Feldtabelle kann das wie eine kurze Sache für einen Nachmittag wirken. In der Praxis bedeutet eine gute Antwort:
Für jeden Kunden im Moment des Eingangs einer Anfrage genaue, aktuelle Nutzungs- und Abrechnungsdaten abzurufen – nicht die Momentaufnahme von gestern.
Ihre internen Daten exakt auf Apples Wertesätze abzubilden und diese Zuordnung korrekt zu halten, wenn Apple sie überarbeitet.
All das innerhalb des ~12-Stunden-Fensters zu erledigen, zu jeder Tages- und Nachtzeit, ohne dass jemand danebensteht.
Einwilligungsstatus, Wiederholungsversuche, Fehler und Protokollierung so zu verwalten, dass Sie nachweisen können, was Sie gesendet haben, und erkennen, ob es funktioniert.
Konzeptionell ist nichts davon schwierig. All das ist jedoch Infrastruktur, die Sie dann für einen Workflow besitzen und pflegen müssten, der nicht Ihr Produkt ist. Zu dieser Abwägung kommen die meisten Teams: Die Felder lassen sich verstehen, aber der Aufbau und die Pflege eines zuverlässigen, fristsicheren, compliance-konformen Responders dafür sind eine dauerhafte Kostenstelle ohne Mehrwert für Ihre eigentliche App.
Genau diese Lücke schließt RefundSensor. Es bildet jedes Feld aus Ihren Daten ab, bleibt mit Apples Änderungen auf dem aktuellen Stand und antwortet automatisch innerhalb des Zeitfensters, sodass die Genauigkeit, die über Rückerstattungen entscheidet, erledigt wird, ohne dass Sie es selbst bauen oder überwachen müssen. Für Teams, die Apple-Rückerstattungs-Automatisierungssoftware vergleichen, entfällt damit die Infrastrukturlast aus dem Workflow.
Offizielle Quellen
Apples Wertesätze und Anforderungen ändern sich, daher sollten Sie die Dokumentation von Apple als maßgebliche Quelle betrachten:
Die Felder lassen sich verstehen. Einen Responder dafür zu pflegen, ist nicht Ihre Aufgabe. RefundSensor bildet jedes ConsumptionRequest-Feld aus Ihren Daten ab und antwortet automatisch innerhalb von Apples Zeitfenster – genau, aktuell und compliance-konform. Kostenlos starten
Häufig gestellte Fragen
Das ist die App Store Server Notification, die Apple sendet, wenn ein Kunde eine Rückerstattung für einen berechtigten Kauf beantragt. Sie fordert Sie auf, Nutzungsdaten zurückzusenden, die Apple in seine Rückerstattungsentscheidung einbezieht.
Felder zu Einwilligung, Nutzungsstatus, Zustellstatus, Kontoalter, Spielzeit, bisherigen Gesamtausgaben und Rückerstattungen, Testinhalten, Kontostatus sowie Ihrer Rückerstattungspräferenz. Jedes davon ist ein Signal, das Apple in die Entscheidung einbezieht.
customerConsented ist eine harte Voraussetzung – ohne dieses Feld wird die Antwort abgelehnt. refundPreference und consumptionStatus beeinflussen das Ergebnis am direktesten, sofern Ihre Belege Ihre Position stützen.
Eine Präferenz hat mehr Gewicht, wenn sie durch genaue Nutzungs- und Zustelldaten gestützt wird. Knappe Antworten geben Apple weniger Grundlage zum Handeln, daher ist die Präferenz allein schwächer als eine Präferenz mit Belegen.
Nein. Apple trifft immer die endgültige Entscheidung. Genaue Daten verbessern Ihre Chancen, geben Ihnen aber kein Vetorecht.
