Nutzerabonnements verwalten

Gehen Sie wie folgt vor, um die Verwaltung von Abonnements in Ihrer Anwendung zu implementieren:

1. Rufen Sie die Liste der Abonnements des Nutzers ab, und zeigen Sie diese in der Anwendung an.
2. Implementieren Sie die Abonnementverwaltung – öffnen Sie das Abonnentenkonto oder verwalten Sie bestimmte Abonnements direkt über Ihre Anwendung.

Eine vereinfachtes Implementierungsbeispiel finden Sie hier.

Nutzerabonnements abrufen

Verwenden Sie die Methode XsollaSubscriptions.GetSubscriptions, um alle aktiven Abonnements des aktuellen Nutzers abzurufen. Die Methode antwortet mit Abonnements, die mit dem Konto des aktuellen Nutzers verknüpft sind und den Status active, non_renewing und freeze aufweisen.die aufweisen.

Mit der Methode XsollaSubscriptions.GetSubscriptionDetails können außerdem detaillierte Informationen zu jedem Abonnement abrufen.

Verwenden Sie zurückgegebenen Daten (das SubscriptionItem-Objekt), um die Benutzeroberfläche zur Abonnementverwaltung in Ihrer Anwendung anzuzeigen.

Wichtige Felder zur Konfiguration von Benutzeroberflächen-Widgets:

• plan_name – Name des Abonnements.
• status – aktueller Abonnementstatus (new, active, canceled, non_renewing, freeze).
• date_next_charge – Datum und Uhrzeit der nächsten automatischen Abbuchung.
• charge – Informationen zu wiederkehrenden Zahlungen. Objekt mit Preis (amount) und Währung (currency).

Abonnementverwaltung

Abonnentenkonto eröffnen

Xsolla bietet eine vorgefertigte Benutzeroberfläche: das Abonnentenkonto. Darüber können die Nutzer Informationen zu ihren Abonnements einsehen und verwalten. Das ist die einfachste und empfohlene Art, die Abonnementverwaltung zu implementieren.

Hauptmerkmale:

• Abonnementdetails einsehen
• Abonnements verwalten: sofortig kündigen, automatische Verlängerung deaktivieren oder reaktivieren (abhängig von den Projekteinstellungen)
• Abo-Modell ändern
• Zahlungsmethode aktualisieren

Rufen Sie die Methode XsollaSubscriptions.GetUserAccountUrl auf, um dem Nutzer das Abonnentenkonto anzuzeigen. Bei erfolgreicher Anfrage wird ein UserAccountLink-Objekt mitsamt Link, der auf die Kontooberfläche verweist, an die Rückruffunktion übermittelt. Mit der Methode XsollaWebBrowser.Open können Sie den Link in einem externen Browser oder im integrierten WebView öffnen.

Verwaltung bestimmter Abonnements

Verwenden Sie die Methode XsollaSubscriptions.GetSubscriptionManagementUrl, um die Verwaltungsoberfläche für ein bestimmtes Abonnement aus Ihrer Anwendung heraus zu öffnen. Bei erfolgreicher Anfrage wird ein PaymentLink-Objekt mitsamt Link, der auf die Verwaltungsoberfläche verweist, an die Rückruffunktion übermittelt. Mit der Methode XsollaWebBrowser.Open können Sie den Link in einem externen Browser oder im integrierten WebView öffnen.

Abonnementkündigung

Verwenden Sie die Methode XsollaSubscriptions.CancelSubscription, um die Kündigung eines Abonnements über die Benutzeroberfläche Ihrer Anwendung durchzuführen. Diese Methode deaktiviert die automatische Verlängerung, und der Abonnementstatus ändert sich in non_renewing. Dadurch erfolgt beim nächsten Abrechnungsdatum keine automatische Abbuchung; das Abonnement bleibt bis zum Ende des bezahlten Zeitraums aktiv.

Abonnementverlängerung

Verwenden Sie die Methode XsollaSubscriptions.GetSubscriptionRenewalUrl, um von Ihrer Anwendung aus zur Benutzeroberfläche für die Abonnementverlängerung zu gelangen. Bei erfolgreicher Anfrage wird ein PaymentLink-Objekt mitsamt Link, der auf die Benutzeroberfläche verweist, an die Rückruffunktion übermittelt. Mit der Methode XsollaWebBrowser.Open können Sie den Link in einem externen Browser oder im integrierten WebView öffnen.