Abonnementabschluss
Gehen Sie wie folgt vor, um den Abschluss von Abonnements in Ihrer Anwendung zu implementieren:
- Rufen Sie die Liste der erhältlichen Abo-Modelle ab, und zeigen Sie sie dem Nutzer an.
- Initiieren Sie den Abschluss des Abo-Modells, das der Nutzer ausgewählt hat.
Eine vereinfachtes Implementierungsbeispiel finden Sie hier.
Nur authentifizierte Nutzer können Abonnements abschließen und verwalten. Informationen zur Verwendung des SDK für die Benutzerauthentifizierung finden Sie im Abschnitt Authentifizierung.
Zu Demonstrationszwecken erfolgt in den Code-Beispielen die Authentifizierung über Nutzername und Passwort (die Methode XsollaAuth.SignIn) mit fest codierten Anmeldedaten. In einer realen Anwendung müssen Sie hingegen die vollständige Authentifizierungslogik und die Validierung der aktuellen Sitzung mithilfe der Methode XsollaAuth.AuthBySavedToken implementieren.
Liste der Abo-Modelle abrufen
Um die Liste der im Kundenportal konfigurierten Abo-Modelle abzurufen, müssen Sie die Methode XsollaSubscriptions.GetSubscriptionPublicPlans oder XsollaSubscriptions.GetSubscriptionPlans aufrufen. Verwenden Sie die zurückgegebenen Daten (das PlanItem-Objekt), um den Abonnementkatalog in Ihrer Anwendung anzuzeigen.
Wichtige Felder zur Konfiguration von Benutzeroberflächen-Widgets:
plan_name– Name des Abonnements.plan_description– Beschreibung der Vorteile des Abo-Modells.charge– Objekt mit Preis (amount) und Währung (currency).period– Abrechnungszeitraum.
Abonnementabschluss initiieren
Um den Kauf eines vom Nutzer ausgewählten Abo-Modells zu initiieren, müssen Sie die Methode XsollaSubscriptions.GetSubscriptionPurchaseUrl aufrufen und dabei den Parameter planExternalId übermitteln. Bei erfolgreicher Anfrage wird ein PaymentLink-Objekt mitsamt Link, der auf die Benutzeroberfläche für die Abonnementverwaltung 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.
Um den Bestellstatus zu tracken, müssen Sie die Webhook-Verarbeitung konfigurieren und Bestellinformationen aufseiten Ihres Anwendungsservers empfangen. Auf diese Weise können Sie eine zusätzliche Überprüfung abgeschlossener Käufe implementieren.
Ausführliche Informationen zur Konfiguration und zum Testen von Webhooks finden Sie im Abschnitt Abonnementinformationen abrufen.
Haben Sie einen Tippfehler oder einen anderen Textfehler gefunden? Wählen Sie den Text aus und drücken Sie Strg+Eingabe.
