Erste Schritte

Integrationsablauf

So integrieren Sie Subscriptions:

  1. Erstellen Sie ein Projekt für Ihr Spiel.
  2. Richten Sie Abo-Modelle ein.
  3. Richten Sie die Autorisierung ein.
  4. Erstellen Sie eine Katalogbenutzeroberfläche.
  5. Konfigurieren Sie, wie das Zahlungsportal geöffnet werden soll.
  6. Implementieren Sie den Abruf von Abonnementinformationen.
  7. Unterzeichnen Sie die Lizenzvereinbarung.

So funktioniert's

Kauf von Abonnements

Automatische Verlängerung von Abonnements

Ablauf für den Nutzer

Begriffserläuterung

Abo-Modell
Abrechnungsbedingungen (Rechnungsbetrag, ‑währung und Abrechnungshäufigkeit), unter denen ein Benutzer Zugang zum Dienst erhält. Die Einrichtung eines Abo-Modells ist ein notwendiger Integrationsschritt.
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
Hinweis
Wenn ein abonnementbasiertes Produkt nicht konfiguriert ist, kann ein Benutzer jeweils nur ein Abonnement abschließen. Um mehrere Abonnements gleichzeitig abzuschließen, müssen Sie die Produkte konfigurieren.
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
Der Zeitraum, in dem der Benutzer das Abonnement testen kann, ohne dafür zu zahlen. Merkmale:
  • 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
Ein Zeitraum des Zahlungsaufschubs. Während dieses Zeitraums können Nutzer, die ihr Abonnement nicht rechtzeitig bezahlt haben, die Dienste weiterhin nutzen: Merkmale:
  • 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.
Wie Sie eine Übergangsfrist festlegen, erfahren Sie in dieser Anleitung.
Zeitraum versuchter Abbuchungen
Ein Zeitraum, in dem versucht wird, von dem gespeicherten Zahlungskonto Geld abzubuchen. In diesem Zeitraum können die Nutzer die Abonnementdienste weiterhin nutzen. Wird nach einer erfolglosen Abbuchung aktiviert. Merkmale:
  • 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.
Wie Sie einen Zeitraum versuchter Abbuchungen festlegen, erfahren Sie in dieser Anleitung.
Automatische Zahlung
Eine Art der Abonnementverlängerung, bei der automatisch das gespeicherte Abrechnungskonto belastet wird. Der Benutzer muss nicht tätig werden. Wenn das Abrechnungskonto nicht gespeichert wurde, ändert sich der Status eines Abonnements mit einer automatischen Zahlung in Non renewing.
Einmalzahlung
Eine Art der Abonnementverlängerung, bei der die Gebühren vom Benutzer über den per E-Mail erhaltenen Zahlungslink gezahlt werden. Wird verwendet, wenn der Benutzer eine Zahlungsmethode auswählt, die keine automatischen Zahlungen unterstützt.

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.

Achtung
Sie können ein Abonnement nicht manuell über die API anlegen — dies kann nur automatisch beim Kauf erfolgen.
  • 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.
Hinweis
Wird ein Abonnement gekündigt, kann die letzte Zahlung erstattet werden. Diese Option steht sowohl dem Partner als auch dem Nutzer zur Verfügung.
  • 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.
Ihr Fortschritt
Vielen Dank für Ihr Feedback!
Letztmalig aktualisiert: 26. Januar 2024

Haben Sie einen Tippfehler oder einen anderen Textfehler gefunden? Wählen Sie den Text aus und drücken Sie Strg+Eingabe.

Problem melden
Wir überprüfen unsere Inhalte ständig. Ihr Feedback hilft uns, sie zu verbessern.
Geben Sie eine E-Mail-Adresse an, damit wir Sie erreichen können
Vielen Dank für Ihr Feedback!