Stripe Billing verwenden, um Abonnements für Commercetools zu aktivieren
Konfigurieren Sie die Stripe-App für Composable Commerce, um Abonnements für jedes Commercetools-Produkt zu aktivieren.
Warning
Dieser Leitfaden gilt nur für die Stripe-App für Composable Commerce und behandelt nicht die Integration der Checkout-App.
Sie können Abonnements für jedes Commercetools-Produkt aktivieren, indem Sie die erforderlichen Attribute und Varianten im Abschnitt Product Catalog des Händlerzentrums in Commercetools definieren. Wenn eine Kundin/eine Kundin ein Abonnementprodukt kauft, verwendet die Integration Stripe Billing, um eine wiederkehrende Zahlung für diese Bestellung zu registrieren. Stripe verwaltet dieses Abonnement und versucht, bei jeder Bestellung in Commercetools den Einzug einer Zahlung auf wiederkehrender Basis. Wenn eine Zahlung fehlschlägt, kann Stripe den Kunden benachrichtigen und ihn auffordern, seine Abrechnungsdetails zu aktualisieren. Sie können dies in Ihren Abonnement- und E-Mail Einstellungen konfigurieren. Wenn eine Zahlung erfolgreich ist, erhält Ihre Website eine Webhook-Benachrichtigung von Stripe. Das Modul erstellt automatisch eine neue Bestellung innerhalb jeder Abonnementverlängerung. Die App berechnet die Versandkosten und Steuerbeträge für jedes einzelne Produkt mit wiederkehrendem Abonnement vor jeder Wiederholung neu.
Bevor Sie loslegen
- Sie haben die Stripe Payment-App für Composable Commerce installiert.
- Stripe Billing ist in Ihrem Stripe-Konto aktiviert.
- Sie haben relevante Produkte und deren Varianten mit dem von der App generierten Produkttyp Zahlung-App-Abonnement-Informationen erstellt.
- Ihr Webhook-Endpoint verarbeitet die folgenden Ereignisse:
invoice.paid invoice.payment_ failed
Konfiguration der Produktvariante
So aktivieren und konfigurieren Sie Abonnements
Abonnements werden automatisch aktiviert, wenn die wiederkehrenden Produkte in der Storefront von Commercetools veröffentlicht werden. Die Produkte werden als einmalig und wiederkehrend im Händlerzentrum von Commercetools konfiguriert. Um eine Produktvariante als Abonnement zu markieren, wenden Sie den benutzerdefinierten Typ Zahlung-App-Abonnement-Informationen an und definieren Sie die folgenden Felder:
| Feld | Beschreibung |
|---|---|
description | Eine Beschreibung für das Abonnement |
recurring_ | Definiert die Abrechnungshäufigkeit (Tag, Woche, Monat, Jahr) |
recurring_ | Gibt die Anzahl der Intervalle zwischen Abrechnungen an |
off_ | Ob das Abonnement Off-Session verwendet werden kann |
collection_ | Methode des Zahlungseinzugs (charge_ oder send_) |
days_ | Optionale Anzahl von Tagen vor Fälligkeit der Rechnung (gilt nur, wenn die Einzugsmethode send_ ist) |
cancel_ | Optionale Markierung zum Stornieren am Ende des aktuellen Zeitraums |
cancel_ | Optionales spezifisches Datum und Uhrzeit für die Kündigung des Abonnements |
billing_ | Optionaler Tag des Monats für die Abrechnung |
billing_ | Optionale Tageszeit für die Abrechnung |
billing_ | Optionales spezifisches Datum und Uhrzeit für Abrechnungs-Anker |
trial_ | Optionale Testzeitraumlänge in Tagen |
trial_ | Optionales spezifisches Datum und Uhrzeit für das Ende des Testzeitraums |
missing_ | Optionales Verhalten bei fehlender Zahlungsmethode am Ende des Testzeitraums (Stornieren, create_ oder Pausieren) |
proration_ | Optionales Verhalten bei anteilmäßiger Verrechnung bei Änderungen (keine, create_ oder always_) |
Übersicht der Kernkomponenten
Das Stripe-Abonnement wird hauptsächlich von den folgenden wesentlichen Diensten verwaltet:
- StripeSubscriptionService: Hauptdienst für Abonnementvorgänge
- CtPaymentCreationService: Führt die Erstellung von CommerceTools-Zahlungen durch
- StripePayment Service: Verwaltet die Zahlungsabwicklung und Auftragserstellung
- SubscriptionEventConverter: Konvertiert Stripe-Ereignisse in CT-Transaktionen
Umgang mit anteilsmäßigen Verrechnungen
Umgang mit anteilsmäßigen Verrechnungen
Diese App unterstützt automatisch anteilmäßige Verrechnungen je nach Produktvariantenkonfiguration im Abschnitt Commercetools Product Catalog. Wenn aktiviert, trifft Folgendes zu:
- Bei Downgrades wird automatisch eine Rückerstattung erstellt und als Teil der ursprünglichen Bestellung erfasst.
- Bei Upgrades, für die eine zusätzliche Zahlung erforderlich ist, wird eine neue Bestellung mit dem anteiligen Betrag für den Rest des Rechnungsstellungszeitraum ausgelöst.
Verfügbare Dienste
Diese Composable-Commerce-App bietet die Kernlogik für die Abonnementverwaltung, einschließlich Support für gemischte Einkaufswagen und die Erstellung von Bestellungen. Die App zeigt die wesentlichen API-Endpoints an, die zur Erweiterung Ihrer Abonnement-Handel-Use-Cases erforderlich sind: Erstellen und Verwalten von Abos, Abrufen der Abonnementliste eines Kunden, Aktualisieren von Abonnements mit anderen Commercetools-Produkten und Kündigen von Abonnements. Sie können die App erweitern, indem Sie verpackte, vorgefertigte Dienste verwenden:
| Endpoint-Service | Methode | Beschreibung |
|---|---|---|
/setupIntent | POST | Kann im Test-Modus verwendet werden, wo eine Zahlungsmethode für zukünftige Zahlungs-Recovery erfasst werden kann |
/subscription/withSetupIntent | POST | Abonnement mit Testeinrichtung für ein Commercetools-Produkt erstellen |
/Abonnement | POST | Abonnement erstellen (ohne Testversion) |
/Abonnement/bestätigen | POST | Zahlung des Abonnements bestätigen und abschließen |
/subscription-api/:customerId | GET | Alle Abonnements für einen bestimmten Kunden / eine bestimmte Kundin abrufen |
/subscription-api/:customerId | POST | Aktualisieren Sie das Abonnement eines Kunden durch ein Upgrade oder Downgrade mit einem neuen Commercetools-Produkt |
/subscription-api/:customerId/:subscriptionId | LÖSCHEN | Ein bestimmtes Abonnement für eine Kundin/einen Kunden kündigen |