Inhalt dieses Artikels
- Vorbemerkungen
- App Store Connect
- Verknüpfung im Merchant Backend erstellen
1. Vorbemerkungen
Um die Apps (Storekit v2) mit dem Merchant Backend von plenigo verknüpfen zu können, werden folgende Angaben benötigt, die im App Store Connect vorliegen:
- Name der App (Bundle-ID)
- App-spezifischer Schlüssel (Shared Secret)
- Issuer ID
- Key ID
- Einrichten des Webhooks
Name der App
Als Name der App wird die eindeutige Bundle-ID verstanden. Die Bundle-ID muss mit der bei der App-Entwicklung (innerhalb X-Code) verwendeten ID übereinstimmen.
Achtung: Bitte nicht die Informationen aus dem Freitextfeld "Name" im App Store Connect Backend verwenden.
App-spezifischer Schlüssel (Shared Secret)
Der App-spezifische Schlüssel (Shared Secret) ist notwendig, um eine Verbindung zwischen der Apple API und der plenigo API herzustellen und zu authentifizieren. Der Shared Secret ist ein eindeutiger Code, um Belege für Abonnements mit automatischer Verlängerung für eine ausgewählte App abzurufen.
Sollen mehrere Apps genutzt werden, muss für jede App ein eigener Shared Secret verwendet werden.
Hinweis: Nur die Rollen Accountinhaber:in und Administrator:in können einen Shared Secret anzeigen und erstellen. |
2. App Store Connect
Folgende Schritte sind durchzuführen, um die notwendigen Informationen aus dem App Store Connect Backend zu erhalten.
1. Name der App (Bundle-ID)
- Im Hauptmenüpunkt Apps die gewünschte App öffnen.
- In der Navigationsleiste auf der linken Seite im Bereich Allgemein > App-Informationen anklicken.
- Im Abschnitt Allgemeine Informationen befindet sich die Bundle-ID (Aufbau der Bundle-ID: com.companyname.appname)
2. Shared Secret
Das Shared Secret ist ebenfalls im Hauptmenüpunkt Apps > gewünschte App > Allgemein > App-Informationen zu finden.
- Im Abschnitt App-spezifischer Schlüssel (Shared Secret) den Link Verwalten anklicken.
- Einen neuen Shared Secret erstellen oder den bestehenden Shared Secret kopieren.
3. Issuer ID und Key ID
- Den Hauptmenüpunkt Benutzer und Zugriffsrechte öffnen.
- Reiter Integration öffnen.
- Als Standard öffnet sich der Unterpunkt App Store Connect-API > Teamschlüssel.
- Hier kann nun die Issuer ID kopiert werden.
- Die Key ID ist in der Tabelle in der Spalte Schlüssel-ID zu finden.
4. Einrichten des plenigo Webhooks
Die Webhook-Einrichtung ist ebenfalls im Hauptmenüpunkt Apps > gewünschte App > Allgemein > App-Informationen zu finden.
- Im Abschnitt App Store-Server-Benachrichtigungen den Link URL einrichten anklicken.
-
Im Feld Produktions-Server-URL die URL des plenigo Webhooks eintragen:
- Stage System: https://callbacks.plenigo-stage.com/callbacks/v1.0/appStore/{companyId}/appleappstore
- Live System: https://callbacks.plenigo.com/callbacks/v1.0/appStore/{companyId}/appleappstore
Die plenigo CompanyId kann im Merchant Backend im gewünschten Mandanten in der URL eingesehen werden: Wo finde ich die CompanyID?
- Auswahl der Version: Version 2
3. Verknüpfung im Merchant Backend erstellen
Die zuvor aus dem App Store Connect kopierten Daten können im nächsten Schritt im plenigo Backend hinterlegt werden.
- Den gewünschten Mandanten öffnen.
- Im Hauptmenüpunkt Einstellungen den Unterpunkt Entwicklung öffnen.
- Den Menüpunkt Mobile Apps öffnen.
- In der Aktionsleiste iOS App hinzufügen anklicken.
- Die Daten aus dem App Store Connect hinterlegen.