Verwalten von Abonnements unter iOSPrivate Vorschau
Akzeptieren Sie wiederkehrende Zahlungen und verwalten Sie Berechtigungen mit dem BillingSDK für iOS.
Akzeptieren Sie Abonnement-Zahlungen, lassen Sie Kunden ihre Abonnements verwalten und verwalten SieBerechtigungen direkt in Ihrer iOS-App mit demBillingSDK für iOS. Das SDK bietet vordefinierte Nutzeroberfläche-Komponenten zum Anzeigen von Kaufschaltflächen, zum Präsentieren des Kundenportals sowie zum Überprüfen der Berechtigungen für Gate-Premium-Funktionen.
Bevor Sie beginnen
Um das BillingSDK für iOS zu verwenden, benötigen Sie Folgendes:
- Ein Backend-Server zum Erstellen von Kunden-Sitzungen
- Ein Stripe-Konto mit Zugriff auf die private Vorschau
- iOS 15.0 oder höher und macOS 12.0 oder höher
- Xcode 15.0 oder höher
Sie werden Folgendes entwickeln
Dieser Leitfaden bietet Informationen zu den folgenden Vorgehensweisen:
- Richten Sie einen Server Endpoint ein, um Kundensitzugngen zu erstellen
- Installieren und Konfigurieren des BillingSDK für iOS
- Anzeigen von Kauf-Schaltflächen für Abonnement-Käufe
- Überprüfen von Berechtigungen für Gate-Premium-Funktionen
- Präsentieren des Kundenportals für die Abonnement-Verwaltung
- Behandeln von Fehlern und Verwalten des Sitzungsstatus
Eine vollständige Beispiel-App finden Sie in der BillingSDK für das iOS-Repository.
Erstellen Sie ein Server-Endpoint zumGenerieren von Kundensitzungen für authentifizierte Nutzer/innen. Diese Sitzungen authentifizieren Ihre iOS-App sicher mit den Abrechnungs-APIs von Stripe.
Erstellen Sie einen Endpoint der Kundensitzung
Der Endpoint muss folgende Anforderungen erfüllen:
- Überprüfen, ob die/der Nutzer/in authentifiziert ist
- Erstellen oder Abrufen der Stripe Kunden-ID für die Nutzerin / den Nutzer
- Erstellen Sie eine Kundensitzung mit aktivierten erforderlichen Komponenten
- Geben Sie die Sitzungsdetails an Ihre App zurück
Hier ist ein Beispiel für eine Implementierung:
Format der Antwort
Der Endpoint muss die folgenden Felder zurückgeben, um eine erfolgreiche Authentifizierung zu gewährleisten:
| Feld | Typ | Beschreibung |
|---|---|---|
clientSecret | Zeichenfolge | Der geheime Schlüssel der Kundensitzung, der zum Authentifizieren des SDK verwendet wird |
expiresAt | Zahl | Ablaufzeitstempel in Sekunden seit Epoch |
customer | Zeichenfolge | Die Stripe-Kunden-ID |
Wenn die Authentifizierung fehlschlägt, geben Sie HTTP 401 zurück, um den nicht authentifizierten Status des SDK auszulösen.
Das BillingSDK für iOS bietet eine native iOS-Oberfläche für die Abonnementverwaltung und die Zugriffssteuerung auf Funktionen.
Hinzufügen des SDK zu Ihrem Projekt
Installieren Sie während der privaten Vorschau das BillingSDK-Paket:
- Öffnen Sie Ihr Projekt in Xcode
- Wählen Sie Datei → Paketabhängigkeiten hinzufügen aus.
- Tippen Sie
https://github.in das Feld Paket-URL suchen oder eingeben eincom/stripe-samples/billing-ios-sdk - Wählen Sie
BillingSDKund klicken Sie auf Paket hinzufügen
Konfigurieren des SDK
Initialisieren Sie das SDK in einer freigegebenen Klasse, um die Einrichtung und Authentifizierung des BillingSDK durchzuführen:
Notiz
Das SDK kümmert sich intern um die Threadsicherheit – Sie können seine Methoden sicher von jedem Thread aus aufrufen.
Einrichten des Anbieters für Kundensitzungen
Fügen Sie die Authentifizierungsmethode Ihrem Abrechnung-Manager hinzu:
Notiz
Das BillingSDK ruft Ihren Sitzungsanbieter automatisch auf, wenn es sich bei Stripe authentifizieren muss. Wenn der Anbieter nil zurückgibt, geht das SDK in einen nicht authentifizierten Zustand über.
Kauf-Schaltflächen bieten ein vordefiniertes Nutzeroberfläche-Element, mit dem Kunden Abonnements erwerben können. Jede Schaltfläche ist mit einem bestimmten Produkt und Preis in Ihrem Stripe-Konto verknüpft.
Erstellen Sie Kauf-Schaltfächen im Dashboard
Folgen Sie den Anweisungen in diesem Leitfaden, um Kauf-Schaltflächen im Dashboard zu erstellen. Wenn Sie die Funktionalität zur Berechtigungsprüfung verwenden möchten, stellen Sie sicher, dass die von Ihnen erstellten Produkte über angehängte Berechtigungen verfügen.
Anzeigen einer Schaltfläche „Kaufen“
Notiz
„Kaufen“-Schaltflächen funktionieren auch, wenn Nutzer/innen nicht authentifiziert sind. Das SDK erstellt bei Bedarf während des Kaufs einen neuen Stripe-Kunden.
Mit Berechtigungen können Sie den Zugriff auf Premium-Funktionen basierend auf den aktiven Abonnements einer Kundin oder eines Kunden regeln.
Überprüfen einer bestimmten Berechtigung
Überprüfen, ob ein/e Nutzer/in Zugriff auf eine bestimmte Funktion hat:
Abrufen aller aktiven Berechtigungen
Rufen Sie alle Berechtigungen ab, auf die die Kundin / der Kunde Zugriff hat:
Überwachen von Berechtigungsänderungen
Richten Sie einen Listener ein, der Sie benachrichtigt, wenn sich Berechtigungen ändern:
Notiz
Wenn keine Sitzung vorhanden ist, getActiveEntitlements() wird ein leerer Array zurückgegeben.
Über das Kundenportal können Abonnenten ihre Abonnements, Zahlungsmethoden und Abrechnungsdaten verwalten.
Zeigen Sie das Kundenportal an
Präsentieren Sie das Portal, wenn Nutzer/innen ihr Abonnement verwalten müssen:
Achtung
Für das Kundenportal ist eine aktive authentifizierte Sitzung erforderlich. Wenn die/der Nutzer/in nicht angemeldet ist, löst das SDK einen.-Fehler aus.
Externe Umleitung (optional)
Sie können das Portal auch in einem Browser öffnen:
Verwenden Sie während der Entwicklung Ihre Sandbox API Schlüssel und Sandbox Kunden-IDs, um echte Gebühren zu vermeiden.
Test-Szenarien
Testen Sie die folgenden häufigen Szenarien:
| Szenario | Schritte |
|---|---|
| Kauf eines neuen Abonnements | Einer/einem neuen Nutzer/in eine „Kaufen“-Schaltfläche anzeigen |
| Abonnementverwaltung | Verwenden des Kundenportals zum Ändern von Plänen |
| Überprüfung der Berechtigung | Überprüfen einer Premium-Funktion mithasEntitlement |
| Fehlerbehebung | Testen Sie die Funktion mit ungültigen Schlüsseln oder abgelaufenen Sitzungen |
| Abmeldungsablauf | Überprüfen Sie, dass billing. die zwischengespeicherte Daten löscht |