Zum Inhalt springen
Refund Sensor

Apple App Store einrichten

Richten Sie Refund Sensor für den Apple App Store ein. Erzeugen Sie einen App-Store-Connect-API-Schlüssel, verbinden Sie ihn und fügen Sie Ihre Webhook-URL hinzu. Etwa 5 Minuten von Anfang bis Ende.

Bevor Sie beginnen

Sie brauchen Folgendes, und es dauert etwa 5 Minuten:

  • Admin- oder Account-Holder-Zugriff auf App Store Connect.
  • Einen App-Store-Connect-API-Schlüssel, der Ihnen drei Werte liefert: eine Issuer ID, eine Key ID und eine private Schlüsseldatei .p8.

Es werden keine Dateien zu Apple hochgeladen und keine Änderungen an Ihrem App-Binary vorgenommen.

API-Schlüssel erzeugen

Issuer ID, Key ID und die .p8-Datei kommen alle von derselben Stelle in App Store Connect:

  1. Melden Sie sich bei App Store Connect an, öffnen Sie Users and Access, wählen Sie den Tab Integrations und links im Bereich Keys In-App Purchase.
  2. Kopieren Sie die Issuer ID oben auf der Seite. Sie ist ein einziger kontoweiter Wert, den jeder erzeugte Schlüssel teilt.
  3. Klicken Sie neben Active auf +, um einen neuen Schlüssel zu erzeugen. Nennen Sie ihn Refund Sensor, setzen Sie Access auf Admin und klicken Sie auf Generate.
  4. Kopieren Sie die Key ID des neuen Schlüssels, klicken Sie dann auf die Schlüsselzeile, um die .p8-Datei per Download zu holen. Apple erlaubt den Download nur einmal, bewahren Sie sie also sicher auf.

Zugangsdaten hinzufügen

Öffnen Sie in Refund Sensor Add app und wählen Sie Apple App Store. Fügen Sie Ihre Issuer ID und Key ID ein, laden Sie die .p8-Datei hoch und klicken Sie auf Continue. Wir prüfen den Schlüssel bei Apple und verschlüsseln ihn im Ruhezustand mit AES-256-GCM, bevor wir ihn speichern. Er wird nie wieder angezeigt und erscheint nicht in Logs.

Apps auswählen

Sobald der Schlüssel geprüft ist, holt Refund Sensor jede App, die es in Ihrem App-Store-Connect-Konto sehen kann. Suchen Sie nach Name oder Bundle-ID, wählen Sie die Apps aus, die Sie verteidigen wollen, und klicken Sie auf Connect. Jede verbundene App erhält ihre eigene Webhook-URL.

Webhook-URL in App Store Connect hinterlegen

Das ist der letzte Schritt, einmal pro App nach dem Verbinden. Apple sendet seine Server-Benachrichtigungen an eine einzige URL:

  1. Kopieren Sie die Webhook-URL der App aus Refund Sensor (sie steht auf der Karte der verbundenen App).
  2. Öffnen Sie in App Store Connect die Seite App Information dieser App und scrollen Sie zu App Store Server Notifications.
  3. Klicken Sie bei Production Server URL auf Set Up URL, fügen Sie die URL ein und speichern Sie. Machen Sie dasselbe für die Sandbox Server URL, damit Test- und Live-Traffic beide bei Refund Sensor ankommen.

Jede verbundene App hat ihre eigene eindeutige URL, die wir für Sie erzeugen und auf ihrer Karte in Refund Sensor anzeigen. Kopieren Sie sie von dort, statt sie abzutippen.

Nutzen Sie schon RevenueCat, Adapty oder Apphud?

Apple erlaubt nur eine URL für Server-Benachrichtigungen, und wenn eine Abo-Plattform sie schon nutzt, ersetzen Sie sie nicht. Sagen Sie dieser Plattform stattdessen, sie soll eine Kopie jeder rohen Apple-Benachrichtigung an Ihre Refund-Sensor-Webhook-URL weiterleiten, dann funktionieren beide weiter. Die genauen Schritte für RevenueCat, Adapty und Apphud stehen unter Weiterleitung von Benachrichtigungen.

Verbindung prüfen

Refund Sensor bestätigt, dass es Apples Benachrichtigungen empfangen kann, bevor es auf echte Ereignisse reagiert. Bis die Verbindung geprüft ist, werden Live-Ereignisse aufgezeichnet, aber nicht bearbeitet, damit eine halb fertige Einrichtung nie versehentlich eine Antwort verschickt.

On this page