# Stripe Subscriptions für Shopify Installieren und konfigurieren Sie die Stripe Subscriptions-App, um wiederkehrende Zahlungen in Ihrem Shopify-Shop zu akzeptieren. Mit der Stripe Subscriptions-App für Shopify können Sie Abonnementpläne für Ihre Produkte erstellen, Rabatte und kostenlose Testversionen anbieten und wiederkehrende Zahlungen über Stripe abwickeln. Kundinnen und Kunden können ihre Abonnements selbst verwalten, und Sie können alle Abonnements sowohl über die Shopify-Verwaltung als auch über das Stripe-Dashboard einsehen und verwalten. ## Bevor Sie beginnen Stellen Sie sicher, dass Sie über Folgendes verfügen: - Ein Shopify-Shop mit einem beliebigen Tarif, der Apps unterstützt - [Erstellen Sie ein Stripe-Konto](https://dashboard.stripe.com/register), falls Sie noch keines haben. - Mindestens ein Produkt in Ihrem Shopify-Shop, das Sie als Abonnement anbieten möchten ### Funktionen dieser App Mit der Stripe Subscriptions App können Sie: - Abonnementpläne für Ihre Produkte erstellen (tägliche, wöchentliche, monatliche oder jährliche Abrechnung - Rabatte und kostenlose Testversionen anbieten, um Abonnentinnen und Abonnenten zu gewinnen - Kundinnen und Kunden ihre eigenen Abonnements verwalten lassen - Wiederkehrende Zahlungsversuche über Stripe verarbeiten und die Zahlung über jeden Abonnement-unterstützenden Zahlungsdienstleister auf Shopify abwickeln - Alle Abonnements in Ihrem Shopify-Adminbereich anzeigen und verwalten ## App installieren 1. Gehen Sie im Shopify-App-Store zu [Stripe-Abonnements](https://apps.shopify.com/stripe-billing). 1. Klicken Sie auf **App hinzufügen**. 1. Überprüfen Sie die für die App erforderlichen Berechtigungen und klicken Sie auf **App installieren**. 1. Die App leitet Sie zum Haupt-Dashboard weiter. ## App einrichten Wenn Sie die App zum ersten Mal öffnen, führen Sie bitte mithilfe der Einrichtungsanleitung die folgenden Schritte aus, um Ihre Abonnementangebote vollständig zu konfigurieren. ### Schritt 1: Verbinden Sie Ihr Stripe-Konto Bevor Sie Abonnementzahlungen akzeptieren können, müssen Sie Ihr Stripe-Konto verknüpfen. 1. Suchen Sie im App-Dashboard den Schritt **Stripe-Konto verbinden** und klicken Sie darauf, um ihn zu erweitern. 1. Vorteile einer Verbindung: - Verwaltung von Abonnements und wiederkehrenden Zahlungen - Zugriff auf Kunden-Zahlungsdaten und Analysen - Wir speichern niemals Ihr Stripe-Passwort 1. (Optional) Um die App vor der Live-Schaltung zu testen, aktivieren Sie bitte das Kontrollkästchen **Test-Modus verwenden**. Dadurch wird eine Verbindung zu Ihrer Stripe-Testumgebung hergestellt, sodass Sie alle Funktionen ausprobieren können, ohne echte Zahlungen zu verarbeiten. 1. Klicken Sie auf **Stripe-Konto verbinden**. 1. Melden Sie sich auf der Autorisierungsseite von Stripe bei Ihrem Stripe-Konto an und klicken Sie auf **Verbinden** oder **Autorisieren**, um der App Zugriff zu gewähren. Wenn Sie im Test-Modus arbeiten, können Sie auf **Dieses Formular überspringen** klicken, um die Kontoaktivierung zu umgehen. 1. Die App leitet Sie mit einer Erfolgsmeldung zurück zum Dashboard weiter. > Falls Sie in Shopify keinen Zahlungsdienstleister für den Test-Modus konfiguriert haben, richten Sie bitte entweder Shopify Payments im Test-Modus oder einen unterstützten Zahlungsdienstleister ein. Die Verarbeitung von Abonnementzahlungen über das Bogus Gateway von Shopify wird nicht unterstützt und führt zu Fehlern. ### Schritt 2: Erstellen Sie Ihren ersten Abonnementplan Ein Abonnementplan legt fest, wie Sie Ihren Kundinnen und Kunden Ihre Produkte in Rechnung stellen. 1. Klicken Sie im Einrichtungsassistenten auf **Plan erstellen** oder klicken Sie im Haupt-Dashboard auf **Neuen Verkaufsplan erstellen**. 1. Legen Sie die **grundlegenden Details** fest: - **Name des Plans**: Geben Sie Ihrem Plan einen Namen (z. B. „Abonnieren und 10 % sparen“). Dieser Name ist für Kundinnen und Kunden sichtbar und wird als Titel der Abonnementoption im Widget auf der Produktseite angezeigt. - (Optional) **Interne Beschreibung**: Fügen Sie Details zu den enthaltenen Leistungen hinzu. Diese Beschreibung ist nur intern sichtbar und nicht für Kundinnen und Kunden einsehbar. Verwenden Sie sie, um Tarife zu unterscheiden, wenn Sie mehrere Tarife mit demselben kundenorientierten Namen haben. - **Produkte auswählen**: Klicken Sie auf **Produkte auswählen**, um auszuwählen, für welche Produkte dieser Plan gelten soll. Sie können ganze Produkte oder bestimmte Varianten auswählen, nach Produkten anhand ihres Namens suchen und mehrere Produkte auswählen. - Klicken Sie auf **Weiter**. 1. Legen Sie den **Plantyp** fest: - Wählen Sie **Pay-as-you-go** (Kundinnen und Kunden zahlen bei jedem Abrechnungszyklus). - Wählen Sie Ihr **Abrechnungsintervall**: täglich, wöchentlich, monatlich oder jährlich. - Klicken Sie auf **Weiter**. 1. Setzen Sie **Rabatte**: Fügen Sie Rabatte hinzu, um Ihr Abonnement attraktiver zu gestalten. - **Kostenloser Testzeitraum**: Bieten Sie Ihren Kundinnen und Kunden einen Testzeitraum, bevor die Abrechnung beginnt. Legen Sie die Anzahl der Testtage fest und fügen Sie optional einen Rabatt nach Ablauf des Testzeitraums hinzu. - **Prozentualer Rabatt**: Bieten Sie einen prozentualen Rabatt an. Wählen Sie die Dauer: einmalig (nur für die erste Bestellung), dauerhaft oder für eine bestimmte Anzahl von Zyklen. - **Festbetrag-Rabatt**: Bieten Sie einen festen Rabattbetrag an. Wählen Sie die Dauer: einmalig, dauerhaft oder für eine bestimmte Anzahl von Zyklen. - Klicken Sie auf **Weiter**. 1. **Überprüfen und bestätigen** Sie Ihre Einstellungen: - Prüfen Sie alle Einstellungen Ihres Plans und klicken Sie auf **Verkaufsplan erstellen**. ### Schritt 3: Fügen Sie das Abonnement-Widget zu den Produktseiten hinzu. Fügen Sie die Abonnementoption zu Ihren Produktseiten hinzu, damit die Kundinnen und Kunden sie sehen können. 1. Klicken Sie im Einrichtungsassistenten auf **Abonnement-Widget hinzufügen**. 1. Navigieren Sie im Shopify Theme Editor zu einer Produktseitenvorlage. Zeigen Sie eine Vorschau eines Produkts an, für das ein Verkaufsplan erstellt wurde, um das Widget auf der Seite anzuzeigen… 1. Suchen Sie in der Seitenleiste des Editors nach **Apps** oder **App-Blöcken** und fügen Sie den Block **Stripe-Abonnement** hinzu. 1. Positionieren Sie den Block an der Stelle, an der Ihre Kundinnen und Kunden ihn sehen sollen (in der Regel in der Nähe der Schaltfläche **In den Warenkorb**). 1. Klicken Sie auf **Speichern** und kehren Sie zur App zurück. Rufen Sie eines Ihrer Produkte mit einem Abonnementplan auf, um das Live-Widget anzuzeigen. ### Schritt 4: Aktivieren Sie die Kundenabonnementverwaltung. Lassen Sie Kundinnen und Kunden ihre Abonnements über ihr Shopify-Konto selbst verwalten. 1. Klicken Sie im Einrichtungsassistenten auf **Abonnementverwaltung aktivieren**. 1. Suchen Sie im Shopify Checkout Editor den Abschnitt „Apps“. Sie können drei Erweiterungen hinzufügen: 1. Aktivieren Sie die Erweiterung **Abonnementverwaltung**. Fügen Sie außerdem einen Menüpunkt hinzu, über den Kundinnen und Kunden ihre Abonnements verwalten können, indem Sie auf **Zum Menü hinzufügen** klicken. 1. Klicken Sie auf **Speichern** und kehren Sie zur App zurück. Kundinnen und Kunden können dann ihre aktiven Abonnements einsehen, anstehende Rechnungsdaten überprüfen, Zahlungs- und Versandinformationen aktualisieren sowie Abonnements pausieren, fortsetzen oder kündigen. ### Schritt 5: Konfigurieren Sie den Kontozugriff nach dem Kauf. Erklären Sie Ihren Kundinnen und Kunden, wie sie nach dem Bezahlvorgang auf ihr Abonnement zugreifen können. 1. Klicken Sie im Einrichtungsassistenten auf den Link **Abonnement hinzufügen**. 1. Suchen Sie in den Shopify-Checkout-Einstellungen die Einstellungen für die **Dankesseite** oder die **Bestellstatusseite**. 1. Aktivieren Sie die Option, um einen Link zum Kundenkonto anzuzeigen. 1. Klicken Sie auf **Speichern** und kehren Sie zur App zurück. Nach Abschluss eines Abonnementkaufs wird den Kundinnen und Kunden auf der Dankesseite ein Link zur Verwaltung ihres Abonnements angezeigt. ### Schritt 6: Personalisieren Sie Benachrichtigungen Wählen Sie aus, welche E-Mails Ihre Kundinnen und Kunden zu ihren Abonnements erhalten sollen. 1. Klicken Sie im Einrichtungsassistenten auf **Kundenbenachrichtigungen bearbeiten**. 1. Überprüfen und passen Sie in den Benachrichtigungseinstellungen von Shopify die Vorlage für die Bestellbestätigungs-E-Mail an. 1. Klicken Sie auf **Speichern** und kehren Sie zur App zurück. > Andere E-Mail-Benachrichtigungen (z. B. über erfolgreiche oder fehlgeschlagene Zahlungen) werden für wiederkehrende Bestellungen über Shopify nicht versendet. Für Abonnements, für die eine von Shopify verwaltete Zahlungsmethode verwendet wird, konfigurieren Sie bitte Benachrichtigungen über fehlgeschlagene Zahlungen über Shopify-Workflows oder benutzerdefinierte Benachrichtigungen mithilfe von Stripe-Webhooks. Für Abonnements, bei denen eine von Stripe verwaltete Zahlungsmethode verwendet wird, konfigurieren Sie bitte E-Mail-Benachrichtigungen im [Stripe-Dashboard](https://dashboard.stripe.com). Um einen Shopify-Ablauf zu erstellen, der Kundinnen und Kunden per E-Mail über fehlgeschlagene Zahlungen informiert, verwenden Sie den Auslöser für den `fehlgeschlagenen Versuch der Abonnement-Abrechnung`. Sie benötigen eine Shopify-Anwendung eines Drittanbieters, um die E-Mail-Sendeaktion bereitzustellen. Einzelheiten zur Implementierung finden Sie in der Dokumentation der Anwendung. ## Abonnements verwalten Öffnen Sie die App und klicken Sie auf **Abonnementverwaltung**, um alle aktiven, pausierten und gekündigten Abonnements anzuzeigen. Auf dieser Seite haben Sie folgende Möglichkeiten: - **Details anzeigen**: Klicken Sie auf ein Abonnement, um alle Details anzuzeigen, darunter Kundeninformationen, Zahlungsstatus, nächstes Rechnungsdatum, Zahlungsmethode und Betrag. - **Pausieren oder fortsetzen**: Beenden Sie vorübergehend die Abrechnung für ein Abonnement. - **Kündigen**: Beenden Sie ein Abonnement. - **Bearbeiten**: Ändern Sie die Abonnementdetails, wie z. B. Posten oder Versandadresse. - **Auftrag erstellen**: Lösen Sie manuell einen Abrechnungsversuch aus. - **In Stripe anzeigen**: Öffnen Sie das Abonnement im Stripe-Dashboard, um erweiterte Verwaltungsfunktionen zu nutzen. Verwenden Sie Filter, um die Ergebnisse nach Abonnementstatus (aktiv, pausiert oder gekündigt) einzugrenzen, suchen Sie nach Kundennamen oder E-Mail-Adresse oder sortieren Sie nach Rechnungsdatum oder Rechnungsbetrag. ### Zahlungsmethoden aktualisieren Kundinnen und Kunden können ihre Zahlungsmethode auf ihrer Kontoseite oder bei einer fehlgeschlagenen Zahlung aktualisieren. ## Einstellungen für Zahlungswiederholungen konfigurieren Fehlgeschlagene Zahlungen sind ein normaler Bestandteil von Abonnementgeschäften. Die App unterstützt die Automatisierung der Rechnungsstellung und benutzerdefinierte Mahnverfahren über Stripe. 1. Gehen Sie in der App zu **Einstellungen für Mahnungen** und klicken Sie auf **Stripe-Dashboard öffnen**. 1. Navigieren Sie in Stripe zu **Einstellungen** > **Abrechnung** > **Abonnements und E-Mails**. 1. Konfigurieren Sie den Zeitplan für Wiederholungsversuche, E-Mail-Benachrichtigungen an Kundinnen und Kunden und Regeln für die Kündigung von Abonnements bei wiederholten Fehlern. > Smart Retries (die auf maschinellem Lernen basierende Wiederholungsfunktion von Stripe) wird derzeit nicht unterstützt, wenn Zahlungen über die Zahlungsplattform von Shopify abgewickelt werden. Sie können jedoch Standard-Wiederholungszeitpläne basierend auf Ihrer Mahnkonfiguration verwenden. Die App bietet Unterstützung für: - Benutzerdefinierte Mahnverfahren mit konfigurierbaren Wiederholungsplänen - Automatische Unterbrechung oder Kündigung des Abonnements bei fehlgeschlagenen Zahlungen - Benutzerdefinierte, in Stripe integrierte [Billing-Automatisierungen](https://docs.stripe.com/billing/automations.md) ### Zahlungsausfälle bearbeiten Wenn eine Zahlung fehlschlägt: 1. Stripe unternimmt automatisch einen erneuten Versuch, basierend auf Ihren Einstellungen für Mahnungen. 1. Sollten alle Wiederholungsversuche fehlschlagen, wird das Abonnement entsprechend Ihren Einstellungen ausgesetzt oder gekündigt. 1. Sie können in [Stripe Billing-Automatisierungen](https://docs.stripe.com/billing/automations.md) benutzerdefinierte Benachrichtigungen und Aktionen erstellen. 1. Ein Ereignis für fehlgeschlagene Zahlungen wird sowohl in Stripe als auch in Shopify erstellt. ## Einstellungen für das Abonnement pausieren 1. Gehen Sie in der App zu **Einstellungen** und suchen Sie den Abschnitt **Abonnement pausieren**. 1. Konfigurieren Sie bitte die folgenden Optionen: - **Kundinnen und Kunden können pausieren und fortsetzen**: Legen Sie fest, ob Kundinnen und Kunden ihr Konto pausieren können. - **Abonnementintervalle pausieren**: Legen Sie vordefinierte Daueroptionen fest, aus denen Kundinnen und Kunden wählen können (z. B. 1 Monat, 2 Monate oder 3 Monate). Konfigurieren Sie die Dauer und Einheit jedes Intervalls (Tage, Wochen, Monate oder Jahre). - **Benutzerdefinierte Dauer**: Ermöglichen Sie es Kundinnen und Kunden, ihr eigenes Lebenslaufdatum zu wählen, mit einer optionalen Höchstgrenze (z. B. 45 Tage) oder ohne Begrenzung. 1. Klicken Sie auf **Speichern**. ## Datensynchronisierung Wenn ein Abonnement erstellt oder aktualisiert wird, synchronisiert die App die Daten zwischen Shopify und Stripe. | Shopify-Objekt | Stripe-Objekt | | --------------------- | ------------- | | Abonnementvertrag | Abonnement | | Kunde/Kundin | Kunde/Kundin | | Verkaufsplan | Preis | | Produkt oder Variante | Produkt | | Rabatt | Gutschein | ### Zurückgestellte Produkt- und Preisgestaltung Wenn Sie einen Abonnementplan erstellen, werden die entsprechenden Stripe-Produkte und -Preise nicht sofort angelegt. Sie werden erst erstellt, wenn der erste Kunde bzw. die ersten Kundin diesen Plan abonniert. ### Metadaten zu Stripe-Objekten Die App fügt automatisch Metadaten zu Stripe-Objekten hinzu, um sie mit den entsprechenden Shopify-Objekten zu verknüpfen. **Metadaten zum Abonnement:** | Schlüssel | Beispielwert | Beschreibung | | ---------------------------------- | ---------------------------------------- | ------------------------------------------------------- | | `shopify_subscription_contract_id` | `gid://shopify/SubscriptionContract/123` | Links zum Shopify-Abonnementvertrag | | `shopify_customer_id` | `gid://shopify/Customer/456` | Links zum Shopify-Kunde/zur Shopify-Kundin | | `shopify_shop_domain` | `your-store.myshopify.com` | Die Shop-Domain | | `shopify_revision_id` | `1` | Verfolgt Synchronisierungsrevisionen zur Konfliktlösung | **Metadaten des Abonnementpostens:** | Schlüssel | Beispielwert | Beschreibung | | ------------------------------- | ------------------------------------ | ------------------------------- | | `shopify_product_gid` | `gid://shopify/Product/789` | Links zum Shopify-Produkt | | `shopify_product_variant_gid` | `gid://shopify/ProductVariant/101` | Links zur spezifischen Variante | | `shopify_selling_plan_gid` | `gid://shopify/SellingPlan/202` | Links zum Verkaufsplan | | `shopify_subscription_line_gid` | `gid://shopify/SubscriptionLine/303` | Links zum Abonnementposten | **Kunden-Metadaten:** | Schlüssel | Beispielwert | Beschreibung | | --------------------- | ---------------------------- | ------------------------------------------ | | `shopify_customer_id` | `gid://shopify/Customer/456` | Links zum Shopify-Kunde/zur Shopify-Kundin | | `shopify_shop_domain` | `your-store.myshopify.com` | Die Shop-Domain | | `stripe_merchant_id` | `acct_xxx` | Das verbundene Stripe-Konto | **Produkt-Metadaten:** | Schlüssel | Beispielwert | Beschreibung | | --------------------- | --------------------------- | ------------------------- | | `shopify_product_gid` | `gid://shopify/Product/789` | Links zum Shopify-Produkt | **Preis-Metadaten:** | Schlüssel | Beispielwert | Beschreibung | | ----------------------------- | ---------------------------------- | -------------------------- | | `shopify_product_variant_gid` | `gid://shopify/ProductVariant/101` | Links zur Shopify-Variante | ### Benutzerdefinierte Attribute aus Shopify-Abonnementverträgen Alle benutzerdefinierten Attribute, die in einem Shopify-Abonnementvertrag definiert sind, werden automatisch in die Metadaten des entsprechenden Stripe-Abonnements kopiert, wenn Sie das Abonnement erstellen. - Benutzerdefinierte Attribute werden ausschließlich bei der Erstellung des Abonnements kopiert. - Benutzerdefinierte Attribute mit `nil`-Werten werden herausgefiltert und nicht kopiert. - Änderungen an benutzerdefinierten Attributen nach dem Erstellen des Abonnements werden nicht automatisch mit Stripe synchronisiert Wenn beispielsweise ein Shopify-Abonnementvertrag die benutzerdefinierten Attribute `custom_field_1`, `custom_field_2` und `order_notes` enthält, umfassen die Stripe-Abonnement-Metadaten diese Schlüssel zusätzlich zu den Standard-Shopify-Metadaten: ```json { "custom_field_1": "custom_value_1", "custom_field_2": "custom_value_2", "order_notes": "Rush delivery requested", "shopify_subscription_contract_id": "gid://shopify/SubscriptionContract/123", "shopify_customer_id": "gid://shopify/Customer/456", "shopify_shop_domain": "your-store.myshopify.com", "shopify_revision_id": "1" } ``` Auf diese Weise können Sie zusätzliche Daten von Shopify an Stripe für Berichts-, Analyse- oder Integrationszwecke übermitteln. Legen Sie benutzerdefinierte Attribute im Shopify-Abonnementvertrag fest, bevor dieser zum ersten Mal synchronisiert wird, um sicherzustellen, dass sie in Stripe angezeigt werden. ### Metadaten zu Shopify-Objekten Die App fügt Shopify-Objekten auch Attribute hinzu: - **Abonnementvertrag**: Ein Attribut `stripe_subscription_id` (z. B. `sub_xxx`) verweist auf das entsprechende Stripe-Abonnement. - **Metafelder des Verkaufsplans** (Namespace: `stripe`): Ein Metafeld `free_trial_amount` speichert die Anzahl der Tage für einen kostenlosen Testzeitraum, sofern dieser konfiguriert ist. ### Spezielle Steuerungsattribute Das folgende Attribut steuert die Webhook-Verarbeitung während Migrationen: | Attributschlüssel | Wert | Beschreibung | | ------------------------------------ | --------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- | | `disable_shopify_webhook_processing` | (`true` oder `false`) | Wenn in einem Shopify-Abonnementvertrag auf `true` gesetzt, werden Webhooks für diesen Vertrag ignoriert. Wird bei Massenmigrationen verwendet. | ## Bericht über Abonnements mit Stripe Sigma Alle über Shopify erstellten Abonnements sind vollständige Stripe-Abonnements. Daher können Sie [Stripe Sigma](https://docs.stripe.com/stripe-data/sigma.md) und Dashboard-Berichte verwenden, um benutzerdefinierte Berichte mit den Shopify-Metadaten zu erstellen, die mit Ihren Stripe-Objekten synchronisiert sind. ### Verfügbare Sigma-Tabellen | Tabelle | Beschreibung | Wichtige Spalten | | ----------------------------- | -------------------------------------------- | ----------------------------------------------- | | `Abonnements` | Alle Abonnementdaten | `id`, `status`, `customer_id`, `created` | | `subscription_items` | Posten innerhalb von Abonnements | `subscription_id`, `price_id`, `quantity` | | `subscription_metadata` | An Abonnements angehängte Metadaten | `subscription_id`, `key`, `value` | | `subscription_items_metadata` | Metadaten zu Abonnementposten | `subscription_item_id`, `key`, `value` | | `customers` | Kundeninformationen | `id`, `email`, `name` | | `customer_metadata` | An Kundinnen und Kunden angehängte Metadaten | `customer_id`, `key`, `value` | | `products` | Produktkatalog | `id`, `name`, `description` | | `product_metadata` | Metadaten zu Produkten | `product_id`, `key`, `value` | | `prices` | Preisinformationen | `id`, `product_id`, `unit_amount`, `currency` | | `price_metadata` | Metadaten zu Preisen | `price_id`, `key`, `value` | | `invoices` | Rechnungsdaten | `id`, `subscription_id`, `amount_due`, `status` | ### Abonnements nach Shopify-Shop-Domain ```sql SELECT sm.value AS shopify_shop_domain, COUNT(s.id) AS subscription_count, SUM(CASE WHEN s.status = 'active' THEN 1 ELSE 0 END) AS active_count FROM subscriptions s JOIN subscription_metadata sm ON s.id = sm.subscription_id AND sm.key = 'shopify_shop_domain' GROUP BY sm.value ORDER BY subscription_count DESC ``` ### Abonnements mit Shopify-Verträgen verknüpfen ```sql SELECT s.id AS stripe_subscription_id, s.status, s.customer_id, c.email AS customer_email, sm_contract.value AS shopify_subscription_contract_id, sm_domain.value AS shopify_shop_domain FROM subscriptions s JOIN customers c ON s.customer_id = c.id LEFT JOIN subscription_metadata sm_contract ON s.id = sm_contract.subscription_id AND sm_contract.key = 'shopify_subscription_contract_id' LEFT JOIN subscription_metadata sm_domain ON s.id = sm_domain.subscription_id AND sm_domain.key = 'shopify_shop_domain' WHERE sm_contract.value IS NOT NULL ``` ### Produkte nach Shopify-Produkt-ID ```sql SELECT p.id AS stripe_product_id, p.name AS product_name, pm.value AS shopify_product_gid FROM products p JOIN product_metadata pm ON p.id = pm.product_id AND pm.key = 'shopify_product_gid' ``` ### Abonnementposten mit Shopify-Variantendetails ```sql SELECT si.subscription_id, si.id AS subscription_item_id, si.quantity, p.name AS product_name, sim_product.value AS shopify_product_gid, sim_variant.value AS shopify_product_variant_gid, sim_plan.value AS shopify_selling_plan_gid FROM subscription_items si JOIN prices pr ON si.price_id = pr.id JOIN products p ON pr.product_id = p.id LEFT JOIN subscription_items_metadata sim_product ON si.id = sim_product.subscription_item_id AND sim_product.key = 'shopify_product_gid' LEFT JOIN subscription_items_metadata sim_variant ON si.id = sim_variant.subscription_item_id AND sim_variant.key = 'shopify_product_variant_gid' LEFT JOIN subscription_items_metadata sim_plan ON si.id = sim_plan.subscription_item_id AND sim_plan.key = 'shopify_selling_plan_gid' ``` ### Monatlich wiederkehrender Umsatz pro Shopify-Shop ```sql SELECT sm.value AS shopify_shop_domain, s.currency, SUM(si.quantity * pr.unit_amount) / 100.0 AS monthly_recurring_revenue FROM subscriptions s JOIN subscription_items si ON s.id = si.subscription_id JOIN prices pr ON si.price_id = pr.id JOIN subscription_metadata sm ON s.id = sm.subscription_id AND sm.key = 'shopify_shop_domain' WHERE s.status = 'active' AND pr.recurring_interval = 'month' GROUP BY sm.value, s.currency ORDER BY monthly_recurring_revenue DESC ``` ### Kundinnen und Kunden mit Shopify-Kundenzuordnung ```sql SELECT c.id AS stripe_customer_id, c.email, c.name, cm_shopify.value AS shopify_customer_id, cm_domain.value AS shopify_shop_domain FROM customers c LEFT JOIN customer_metadata cm_shopify ON c.id = cm_shopify.customer_id AND cm_shopify.key = 'shopify_customer_id' LEFT JOIN customer_metadata cm_domain ON c.id = cm_domain.customer_id AND cm_domain.key = 'shopify_shop_domain' WHERE cm_shopify.value IS NOT NULL ``` ### Benutzerdefinierte Attribute für die Geschäftsberichterstattung Wenn Sie Ihren Shopify-Abonnementverträgen benutzerdefinierte Attribute hinzugefügt haben (die in die Stripe-Metadaten kopiert werden), können Sie diese für Berichtszwecke abfragen: ```sql SELECT sm_tier.value AS plan_tier, COUNT(s.id) AS subscription_count, SUM(CASE WHEN s.status = 'active' THEN 1 ELSE 0 END) AS active_subscriptions, SUM(CASE WHEN s.status = 'canceled' THEN 1 ELSE 0 END) AS canceled_subscriptions FROM subscriptions s JOIN subscription_metadata sm_tier ON s.id = sm_tier.subscription_id AND sm_tier.key = 'plan_tier' GROUP BY sm_tier.value ORDER BY subscription_count DESC ``` ### Auf Sigma zugreifen 1. Gehen Sie zu Ihrem [Stripe Dashboard](https://dashboard.stripe.com). 1. Navigieren Sie zu **Berichterstattung** > **Sigma**. 1. Verwenden Sie den Abfrage-Editor, um SQL-Abfragen zu erstellen. 1. Speichern Sie Abfragen für die wiederholte Verwendung. 1. Planen Sie Abfragen für die automatische Ausführung und den Export in CSV. Sigma unterstützt auch einen KI-Abfrageassistenten. Sie können Ihre Anforderungen in einfachem Englisch beschreiben, und er generiert die SQL für Sie. ### Finanzberichte im Dashboard Neben Sigma können Sie auch die Finanzberichte im Stripe-Dashboard verwenden, die Metadaten-Spalten unterstützen: 1. Bitte gehen Sie zu **Berichte** > **Finanzberichte**. 1. Bitte wählen Sie einen Berichtstyp aus (Saldo, Auszahlungsabgleich oder Aktivität). 1. Bitte klicken Sie auf **Alle Spalten**, um Metadatenfelder einzubeziehen. 1. Laden Sie den Bericht herunter. Die Metadaten aus Ihren Shopify-Objekten werden in diesen Berichten als zusätzliche Spalten angezeigt, sodass Sie die Stripe-Daten mit Ihren Shopify-Shopdaten abgleichen können. ## Wichtige Überlegungen ### Zahlungsmethoden direkt bei Stripe Die App verwendet standardmäßig von Shopify verwaltete Zahlungsmethoden. Wenn ein Abonnement migriert wird oder die Zahlungsmethode eines Kunden oder einer Kundin in Stripe auf eine von Stripe verwaltete Zahlungsmethode aktualisiert wird: - Zahlungen werden direkt über Stripe abgewickelt - Das Abonnement wird weiterhin in Shopify angezeigt - Bestellungen „are *not* created“ in Shopify - Zahlungsaufzeichnungen „are *not* created“ in Shopify > Wenn ein Abonnement auf eine von Stripe verwaltete Zahlungsmethode umgestellt wird, werden Bestellungen für dieses Abonnement nicht mehr automatisch in Shopify erstellt. Dies kann sich auf die in Shopify integrierte Fulfillment-Logik auswirken. ### Billing-Automatisierungen Die Anwendung unterstützt die automatische wiederkehrende Abrechnung basierend auf dem Intervall Ihres Tarifs, benutzerdefinierte Mahnrichtlinien für die Bearbeitung fehlgeschlagener Zahlungen, automatische Aktualisierungen des Abonnementstatus und Änderungen während des Abrechnungszeitraums. ### Bestehende Abonnements migrieren Wenden Sie sich an den Support, um Unterstützung bei der Migration von Abonnements zu erhalten. Ein eigens dafür vorgesehener Migrationsvorgang ermöglicht die Übertragung von Abonnementdaten unter Beibehaltung der Zahlungsmethoden der Kundinnen und Kunden. ### Rückerstattungen ausstellen Bearbeiten Sie Rückerstattungen über Shopify.