In-App-Käufe

Mit der Einführung der In-App-Kauf-Abonnements erhältst du als Extension-Partner die Möglichkeit, Premium-Funktionen direkt innerhalb deiner Erweiterungen anzubieten. Diese Abonnements können von Händlern über ein von Shopware bereitgestelltes Kaufmodul in der Shopware Administration gebucht werden.

Dieses Feature erhöht die Flexibilität deiner Monetarisierungsstrategie und erlaubt es dir, sowohl kostenlosen als auch bereits kostenpflichtigen Erweiterungen einen zusätzlichen Mehrwert zu verleihen.

Was sind In-App-Kauf-Abonnements?

In-App-Kauf-Abonnements (IAP-Abonnements) ermöglichen es dir, innerhalb deiner Erweiterung zusätzliche Funktionen anzubieten, die Händler über ein monatliches oder jährliches Abonnement freischalten können.

Du kannst Abonnements verwenden, um:

Einer bestehenden kostenpflichtigen Erweiterung weiteren Mehrwert hinzuzufügen.
Premium-Upgrades für ansonsten kostenlose Erweiterungen anzubieten.

Der gesamte Kaufprozess wird von Shopware abgewickelt, sodass du diesen lediglich aus deiner Erweiterung heraus auslösen musst.

Die Abrechnung von In-App-Käufen erfolgt wie gewohnt über die monatliche Shopware Rechnung.

Abonnement-Gruppen und -Stufen

Um ein In-App-Kauf-Abonnement zu erstellen, musst du zunächst eine Abonnement-Gruppe anlegen.

Eine Gruppe ist immer erforderlich, auch wenn du nur ein einziges Abonnement anbietest.
Jede Gruppe kann eine oder mehrere Abonnements enthalten.
Händler können pro Gruppe nur ein Abonnement gleichzeitig besitzen.

Wenn eine Gruppe mehrere Abonnements enthält, können Händler:

Upgrades jederzeit durchführen (die teurere Stufe wird sofort aktiv).
Downgrades durchführen, wobei die Änderung zum Beginn des nächsten Abrechnungszeitraums wirksam wird.

Preisoptionen

Du kannst folgende Preise definieren:

Monatliche Preise für alle Stufen.
Jährliche Preise zusätzlich zu den monatlichen Preisen, allerdings nur für Stufen, die kostenlosen Erweiterungen zugeordnet sind.

Preisinformationen werden automatisch im Checkout-Modul angezeigt, das dem Händler zur Verfügung gestellt wird.

Zuweisung von Abonnements zu Erweiterungen

Nachdem du deine Abonnement-Gruppe und -Stufen erstellt hast, musst du diese bestimmten Erweiterungen zuweisen.

Dabei gelten folgende Regeln:

Nur Erweiterungen mit einem gültigen Preismodell können ausgewählt werden.
Die Erweiterung muss mit Shopware Version 6.6.9.0 oder höher kompatibel sein.
Wird eine jährliche Preisoption angeboten, muss die Erweiterung kostenlos sein.
Der Support wird automatisch für Erweiterungen aktiviert, die diesen bisher nicht enthalten haben.

Erfahrung der Händler

Shopware übernimmt den kompletten Checkout-Prozess.

Beim Auslösen des Kaufs erscheint ein Modal in der Shopware Administration.
Dieses Modal enthält Informationen zu Stufe, Preis und Bedingungen.
Nach Bestätigung wird das Abonnement sofort für den Händler aktiv.

Du musst diesen Kaufprozess lediglich aus deiner Erweiterung heraus auslösen. Es sind keine zusätzlichen Integrationen im Interface oder Abrechnungssystem erforderlich.

Empfang und Verifizierung von Käufen

Wenn ein Händler ein Abonnement kauft, sendet Shopware die Informationen auf sichere Weise an Ihre App.

Du erhältst ein JWT (JSON Web Token) von Shopware, das die Daten des In-App-Kaufs enthält.
Dieses JWT kann als Query-Parameter (GET) oder im Request-Body (POST) übermittelt werden, je nach Kontext.
Du musst die Signatur verifizieren, um sicherzustellen, dass die Daten von Shopware stammen und nicht manipuliert wurden.

Für eine einfache Integration kannst du folgende Tools verwenden:

Shopware App PHP SDK für PHP-Anwendungen.
Shopware App Bundle für Symfony-basierte Apps.

In der Administration können aktive In-App-Käufe ausgelesen und in Ihre Erweiterungslogik übernommen werden. So kannst du Premium-Funktionen gezielt auf Basis des aktiven Abonnements freischalten.

Erste Schritte

Um In-App-Kauf-Abonnements anzubieten:

1. Navigiere in deinem Shopware Account zu Extension Partner > In-App-Käufe (1) und klicke zur Erstellung einer neuen Abonnement-Gruppe auf Abonnement-IAK erstellen (2).