Erste Schritte
Integrationsablauf
So integrieren Sie Subscriptions:
- Erstellen Sie ein Projekt für Ihr Spiel.
- Richten Sie Abo-Modelle ein.
- Richten Sie die Autorisierung ein.
- Erstellen Sie eine Katalogbenutzeroberfläche.
- Konfigurieren Sie, wie das Zahlungsportal geöffnet werden soll.
- Implementieren Sie den Abruf von Abonnementinformationen.
- Unterzeichnen Sie die Lizenzvereinbarung.
So funktioniert's
Kauf von Abonnements
Automatische Verlängerung von Abonnements
Ablauf für den Nutzer
Begriffserläuterung
Abo-Modell
Abonnementbasiertes Produkt
Ein Dienst oder eine Reihe von Diensten, die einem Benutzer bei Abschluss des Abonnements zur Verfügung gestellt werden. Der API-Aufruf Produkt erstellen dient dazu, ein Produkt zu erstellen. Sie müssen ein Produkt erstellen, wenn Sie den Verkauf von separaten Abonnements für verschiedene Dienste planen oder wenn Sie einem Benutzer die Möglichkeit geben wollen, mehrere Abonnements gleichzeitig abzuschließen. Ein abonnementbasiertes Produkt ist beispielsweise der Zugang zum Kanal eines Streamers, zu einem Spiel oder ein einzigartiges Item/eine einzigartige Fähigkeit. Wie Sie abonnementbasierte Produkte einrichten und nutzen, erfahren Sie in dieser Anleitung.
Abonnement
Eine Kombination aus dem Produkt und dem gewählten Abo-Modell. Ein Abonnement wird abgeschlossen, wenn ein Benutzer einen Abo-Modell auswählt und Zugang zu einem Dienst erhält. Die Anzahl der Abonnements, die ein Benutzer gleichzeitig abschließen kann, hängt von der Anzahl der Produkte im Projekt ab. Die Abonnementbedingungen (Abrechnungszeitraum, Kosten und andere) entsprechen den Bedingungen des ausgewählten Abo-Modells. Die Bedingungen des bestehenden Abonnements ändern sich nicht, wenn die Bedingungen des Abo-Modells nach Abschluss des Abonnements geändert wurden.
BEISPIEL 1
Produkt: Zugang zum Spiel
- Abo-Modell
Silver : 10 $ pro Monat - Abo-Modell
Gold : 100 $ pro Jahr
Benutzer können eines der folgenden Abonnements auswählen:
- Abonnement 1: Zugang zum Spiel mit dem 10-$-Monatsabo
- Abonnement 2: Zugang zum Spiel mit dem 100-$-Jahresabo
BEISPIEL 2
Produkt 1: Zugang zu Spiel 1
Produkt 2: Zugang zu Spiel 2
- Abo-Modell: 10 $ pro Monat
Ein Benutzer kann gleichzeitig zwei Abonnements abschließen:
- Abonnement 1: Zugang zu Spiel 1 mit dem 10-$-Monatsabo
- Abonnement 2: Zugang zu Spiel 2 mit dem 10-$-Monatsabo
Gruppe von Abo-Modellen
Eine Reihe von Abo-Modellen mit demselben Wert für den Parameter group_id
.
Um eine Gruppe zu erstellen oder zu ändern, übermitteln Sie den Parameter group_id
an die API-Aufrufe:
Sie müssen zwingend eine Gruppe von Abo-Modellen erstellen, wenn Sie:
ein abonnementbasiertes Produkt erstellen möchten;
die Anzahl der für ein Produkt abonnierbaren Abo-Modelle einschränken möchten;
Benutzern gestatten möchten, zu einem anderen Abo-Modell innerhalb der Gruppe zu wechseln.
Wie Sie Gruppen einrichten und nutzen, erfahren Sie in dieser Anleitung.
Probezeitraum
- Bei Abschluss eines Abonnements mit Probezeitraum wird ein Abrechnungskonto erstellt und eine Autorisierungszahlung vorgenommen. Es wird ein kleiner Betrag vom Konto des Benutzers abgebucht und anschließend zurückerstattet. Nach Abbuchung der Zahlung wird kein Zahlungs-Webhook an die Webhook-URL gesendet.
- Nach Ablauf des Probezeitraums werden die vollen Kosten für das Abonnement in Rechnung gestellt, außerdem werden die beiden Webhooks Zahlung und Aktualisiertes Abonnement an die Webhook-URL gesendet. Falls die Zahlung für das Abonnement nicht erfolgreich war, wird der Webhook Gekündigtes Abonnement gesendet. Der Probezeitraum ist nicht in der Gültigkeitsdauer des Abo-Modells inbegriffen und seine Dauer wird separat berechnet.
- Ein Probezeitraum kann einer Werbeaktion als Bonus hinzugefügt werden.
Übergangsfrist
- Die Übergangsfrist ist nur für reguläre Abo-Modelle und Abonnements mit Einmalzahlung verfügbar. Abonnements mit automatischer Vertragsverlängerung werden automatisch abgerechnet.
- Xsolla sendet dem Nutzer zu Beginn der Übergangsfrist und an jedem weiteren Tag eine Zahlungserinnerung.
- Wenn der Nutzer während der Übergangsfrist die Abo-Gebühr entrichtet, wird die Zahlung für den gesamten Zahlungszeitraum geleistet.
- Die Anzahl der Tage, an denen der Nutzer Zugriff auf den Dienst des Partners hat, ohne tatsächlich zu bezahlen, wird von der Gesamtzahl der Tage des Abonnementzeitraums abgezogen.
- Ist in den Abo-Modell-Einstellungen im Feld Übergangsfrist der Wert
0
festgelegt, hat das Abo-Modell keine Übergangsfrist.
Zeitraum versuchter Abbuchungen
- Der Zeitraum versuchter Abbuchungen ist nur für reguläre Abo-Modelle und Abonnements mit automatischer Zahlung.
- Einmal pro Tag wird versucht, den Betrag von dem gespeicherten Zahlungskonto abzubuchen.
- Das System versucht so lange, Geld abzubuchen, bis das Abonnement verlängert, vom Nutzer gekündigt oder nach Überschreitung der Anzahl der Abrechnungsversuche gekündigt wird.
- Wenn ein Nutzer das Abonnement vor Ablauf dieses Zeitraums verlängert, wird die Anzahl der Tage, an denen der Nutzer Zugriff auf den Dienst des Partners hat, ohne tatsächlich zu bezahlen, von der Gesamtzahl der Tage des Abonnementzeitraums abgezogen.
- Ist in den Abo-Modell-Einstellungen im Feld Anzahl der erneuten Abrechnungsversuche der Wert
0
festgelegt, hat das Abo-Modell keinen Zeitraum versuchter Abbuchungen.
Automatische Zahlung
Einmalzahlung
Abonnement-Status
Ein Abonnement kann einen der folgenden Status aufweisen:
- Aktiv. Primärer Status. Das Abonnement wird nach der ersten erfolgreichen Zahlung angelegt und aktiviert. Weitere Gebühren können lediglich bei aktiven Abonnements anfallen.
- Gekündigt. Das Abonnement wurde mit sofortiger Wirkung aus einem der folgenden Gründe gekündigt:
- Status wurde über eine API-Methode oder über das Xsolla-Kundenportal geändert.
- durch Nutzer gekündigt.
- Abgelaufen, falls ein Ablaufdatum in den Parametern festgelegt wurde.
- Maximale Anzahl der Abbuchungsversuche überschritten. Standardmäßig ist Drei voreingestellt. Bitte wenden Sie sich an Ihren Customer Success Manager oder senden Sie eine E-Mail an csm@xsolla.com, wenn Sie diesen Wert ändern möchten.
- Benutzer konnte im Spiel nicht gefunden werden.
- Benutzerkonto wurde gelöscht.
- Nicht verlängert. Verlängerung des Abonnements deaktiviert. Das Abonnement läuft bis zum Ende des aktuellen Abrechnungszeitraums weiter. Danach erfolgt ein Statuswechsel zu "Gekündigt". Eine Verlängerung kann aus einem der folgenden Gründe deaktiviert werden:
- Status wurde über eine API-Methode oder über das Kundenportal geändert.
- Deaktiviert durch Nutzer per, in E-Mail enthaltenem Link.
- Benutzerkonto wurde gelöscht.
Haben Sie einen Tippfehler oder einen anderen Textfehler gefunden? Wählen Sie den Text aus und drücken Sie Strg+Eingabe.