Ein Abonnent tauscht ein Produkt um, sieht einen angepassten Gesamtbetrag und erwartet, dass die nächste Abrechnung genau diesem entspricht. Genau an dieser Erwartungshaltung kann das Abo-Management in Shopify teuer werden: Die Kontoseite, die Abo-App und die Rechnungsberechnung müssen alle übereinstimmen. Shopifys neue SubscriptionContractCalculation-API bietet Entwicklern eine bessere Möglichkeit, Vertragsänderungen zu berechnen, bevor sie gespeichert werden. Für Händler ist der Nutzen praktisch: weniger unerklärliche Abbuchungen und weniger manueller Korrekturaufwand. Hier erfahren Sie, was Sie Ihren App-Anbieter fragen sollten und wie Sie die Änderung testen, ohne die Verlängerungen zu gefährden.
Was sich im Shopify-Abo-Management geändert hat
Die Plattform-Updates von Shopify vom Oktober enthalten eine Änderung, die für jede Marke, die wiederkehrende Lieferungen anbietet, von Bedeutung ist. Laut der Ankündigung zur SubscriptionContractCalculation-API laufen Änderungen an Abo-Verträgen nun über die Checkout-Engine von Shopify.
Die neue API unterstützt Shopify Functions bei Vertragsberechnungen, einschließlich Warenkorb-Transformationen und Lieferanpassungen. Entwickler können den berechneten Vertrag inklusive Gesamtsummen, Lieferoptionen und Warnungen zudem als Vorschau anzeigen lassen, bevor sie die Änderungen dauerhaft speichern.
Ein Abo-Vertrag hält die Vereinbarung für wiederkehrende Käufe fest. Eine Vertragsberechnung zeigt die Auswirkungen einer Änderung vorab, bevor diese zur gespeicherten Vereinbarung wird.
Shopify empfiehlt Entwicklern, die SubscriptionDraft verwenden, auf SubscriptionContractCalculation zu migrieren. Die ältere API bleibt verfügbar, unterstützt jedoch nicht die neuen Funktionen. Dies ist eine Migration, die geplant werden sollte, und kein Hinweis darauf, dass bestehende Abo-Implementierungen nicht mehr funktionieren.
Unsere Ansicht: Die Vorschau ist der kommerziell nützlichste Teil. Sie schafft die Möglichkeit, Kunden ein berechnetes Ergebnis zu zeigen, bevor sie sich festlegen. Aber eine API-Funktion hilft nur dann, wenn Ihre Abo-App und das Kundenerlebnis sie auch korrekt nutzen.
Warum ein gewöhnlicher Produktwechsel sorgfältige Handhabung erfordert
Betrachten wir ein beispielhaftes Kaffee-Abo. Ein Kunde erhält jeden Monat eine Packung und entscheidet sich für eine größere Größe. Diese Änderung kann die Versandberechtigung beeinflussen oder mit einer Bundle-Regel kollidieren. Ein Portal, das einfach den Produktpreis ersetzt, kann hier ein unvollständiges Ergebnis liefern.
Der Händler hat dann zwei Probleme. Der Kunde stimmt einer Änderung zu, ohne deren Kosten zu verstehen, und der Support muss eine Abbuchung erklären, für die der Kunde nie eine Grundlage sah.
Die neue Berechnungs-API bietet einen Weg zu einem zuverlässigeren Änderungsprozess. Das bedeutet nicht, dass jede installierte App sofort präzise Vorschauen anzeigt oder dass jede benutzerdefinierte Checkout-Regel automatisch mit Abos funktioniert.
Fragen Sie Ihren Anbieter, welche Functions Ihr Shop nutzt und welche davon in die Abo-Berechnungen einfließen. Lassen Sie sich den tatsächlichen Produktwechsel an Ihrem Shop demonstrieren. Ein generischer Demo-Shop wird die Bedingungen in Ihrem Katalog nicht abbilden.
Wir würden diese Arbeit priorisieren, bevor wir das Design eines Abo-Portals verschönern. Eine klarere Oberfläche hilft, aber der Betrag hinter dem Bestätigungsbutton muss vertrauenswürdig sein.
Prüfen Sie Ihr Shopify-Abo-Management vor der Migration
Beginnen Sie mit den Wegen, über die Verträge geändert werden. Kunden können Abos über ein App-Portal ändern, während Mitarbeiter separate Admin-Masken nutzen. Ihr Unternehmen könnte zudem benutzerdefinierte Skripte für nicht mehr erhältliche Produkte oder Massenpreisänderungen haben.
Notieren Sie jeden Pfad und den technischen Verantwortlichen. Halten Sie dann fest, welches System die überarbeitete Vereinbarung berechnet und welches sie speichert. Dies offenbart oft, dass eine vermeintlich einheitliche Abo-Erfahrung aus mehreren unabhängigen Implementierungen besteht.
Stellen Sie Ihrem App-Anbieter spezifische Fragen
- Nutzen Sie aktuell SubscriptionDraft, SubscriptionContractCalculation oder einen anderen Prozess für Vertragsänderungen?
- Werden Änderungen durch den Kunden und durch Mitarbeiter denselben Berechnungspfad nutzen?
- Welche unserer Shopify Functions haben Sie während der Vertragsberechnungen getestet?
- Können Kunden die berechneten Gesamtsummen und verfügbaren Lieferoptionen vor der Bestätigung sehen?
- Wie werden Warnungen, fehlgeschlagene Berechnungen und nicht erfolgreiche Speicherungen angezeigt?
- Was passiert, wenn sich ein Vertrag nach einer Vorschau, aber vor der Bestätigung durch den Kunden ändert?
Verlangen Sie Nachweise aus einer Testumgebung, nicht nur ein Datum aus einer Roadmap. Ein Anbieter kann die API zwar unterstützen, während sein Portal immer noch eine ältere, lokal berechnete Schätzung anzeigt.
Wenn Sie eine verwaltete Abo-App nutzen, überlassen Sie dem Anbieter die API-Implementierung, es sei denn, Sie haben triftige Gründe für eine Anpassung. Der Aufbau eines parallelen Berechnungsdienstes schafft ein weiteres System, das abgeglichen werden muss. Maßgeschneiderte Arbeit ist sinnvoller, wenn Ihre Abo-Regeln die unterstützten Workflows der App tatsächlich übersteigen.
Gestalten Sie den Änderungsprozess rund um eine berechnete Vorschau
Unser empfohlener Ablauf beginnt, wenn der Kunde eine Änderung vorschlägt. Ihre Integration fragt eine Berechnung an und erhält das Ergebnis. Die Oberfläche präsentiert dann die relevanten Gesamtsummen und Lieferoptionen, bevor der Kunde bestätigt.
Eine Vorschau ist keine gespeicherte Änderung. Die Benutzeroberfläche sollte diesen Unterschied klar hervorheben. Zeigen Sie keine Erfolgsmeldung an, nur weil die Berechnung erfolgreich abgeschlossen wurde.
Überprüfen Sie nach der Bestätigung, ob das Speichern erfolgreich war, und zeigen Sie die aktualisierte Vereinbarung an. Falls das Speichern fehlschlägt, behalten Sie den bestehenden Vertrag bei und erklären Sie, dass die angeforderte Änderung nicht in Kraft getreten ist.
Warnungen benötigen ebenfalls eine durchdachte Behandlung. Die API-Ankündigung besagt, dass Vorschauen Warnungen enthalten, definiert jedoch nicht die Reaktion Ihres Shops auf jede mögliche Warnung. Lassen Sie den Entwickler die tatsächlichen Reaktionen auf das Kundenverhalten abstimmen. Manche benötigen eine Erklärung; andere könnten es rechtfertigen, die Änderung zu stoppen, bis das Problem gelöst ist.
Gehen Sie beim Timing ebenso vorsichtig vor. Eine Vorschau sollte basierend auf dem unterstützten Verhalten Ihrer App angeben, welche anstehende Lieferung oder welcher Abrechnungszeitraum von der Änderung betroffen ist. Versprechen Sie keine sofortige Änderung, wenn die relevante Bestellung bereits in der Erfüllungsphase ist.
Vermeiden Sie den Eindruck, dass eine Vorschau jede zukünftige Abbuchung garantiert. Spätere Änderungen oder andere geltende Anpassungen können die Vereinbarung beeinflussen. Zeigen Sie, was die Berechnung aktuell festlegt, und zwar in einer Sprache, die der Abonnent versteht.
Testen Sie die heiklen Fälle, bevor der „Happy Path“ genehmigt wird
Ein erfolgreicher Produktwechsel ist notwendig, reicht aber nicht für die Freigabe zur Veröffentlichung aus. Erstellen Sie eine kleine Testmatrix aus den Regeln, die Ihr Shop tatsächlich verwendet. Dies sind empfohlene Tests, keine Aussagen über eine automatische API-Abdeckung.
- Mengenänderungen: Vergleichen Sie eine einfache Erhöhung mit einer Änderung, die eine Ihrer Versandgrenzen überschreitet.
- Produktwechsel: Testen Sie einen Ersatz mit einem anderen Preis sowie einen, der andere Lieferbeschränkungen hat.
- Funktionsabhängige Produkte: Verifizieren Sie unterstütztes Bundle- oder Warenkorb-Transformationsverhalten durch Berechnung und Speicherung.
- Nicht verfügbare Optionen: Prüfen Sie die Reaktion, wenn die angeforderte Lieferoption nicht mehr gültig ist.
- Konfliktäre Änderungen: Lassen Sie einen Kunden und einen Supportmitarbeiter versuchen, Änderungen am selben Vertrag vorzunehmen.
- Unterbrochene Anfragen: Wiederholen Sie den Vorgang nach einem Timeout und bestätigen Sie, dass die Integration dieselbe Änderung nicht doppelt anwendet.
- Abrechnungsgrenzen: Testen Sie eine Änderung kurz vor der Verlängerung unter Verwendung des dokumentierten Cutoff-Verhaltens der App.
Behalten Sie für jeden Fall die Vorschau und das gespeicherte Vertragsergebnis bei. Wo Ihre Testumgebung dies unterstützt, vergleichen Sie diese mit dem resultierenden Abrechnungsergebnis. Dokumentieren Sie jede Abweichung und deren Begründung.
Die Release-Freigabe sollte die Übereinstimmung zwischen diesen Phasen unter den getesteten Bedingungen voraussetzen. „Die Anfrage war erfolgreich“ ist zu schwach. Sie müssen sicherstellen, dass der Kunde dieselbe Änderung genehmigt hat, die Ihr System gespeichert hat.
Ein zweites Update hilft, Abo-Bestellungen mit Plänen zu verknüpfen
Eine weitere Veröffentlichung vom Oktober adressiert ein kleineres Integrationsproblem. Shopify gibt an, dass Orders-Webhooks nun selling_plan_id in den Posten ab API-Version 2026-10 enthalten.
Das Feld identifiziert den Verkaufsplan (Selling Plan), der auf einen Abo-Posten angewendet wird. Bei Posten ohne Verkaufsplan ist es null. Zuvor musste eine Integration, die diese Information benötigte, einen zusätzlichen Admin-API-Aufruf tätigen; der Wert wird nun im Webhook-Payload mitgeliefert.
Für einen Händler ist die nützliche Frage, ob eine Integration zur Bestellabwicklung immer noch diesen zusätzlichen Suchaufruf tätigt. Bitten Sie den Entwickler, dies bei der Umstellung auf die relevante API-Version zu prüfen. Das Entfernen einer unnötigen Anfrage kann den Verarbeitungspfad vereinfachen.
Halten Sie die Bedeutung des Feldes eng gefasst. Eine Selling-Plan-ID ist kein Ersatz für den Abo-Vertrag oder eine vollständige Abrechnungshistorie. Untersuchen Sie in einem gemischten Warenkorb jeden Posten einzeln, anstatt die gesamte Bestellung als Abo zu behandeln.
Wählen Sie den Migrationsumfang nach operativem Risiko
Wir würden Shops priorisieren, in denen Kunden regelmäßig Produkte tauschen, in denen der Support manuell Abo-Änderungen korrigiert oder in denen benutzerdefinierte Functions die Vereinbarung beeinflussen. Diese Händler haben einen konkreten Workflow, den es zu verbessern gilt.
Ein Shop mit festen Abos und ohne Self-Service-Bearbeitung hat möglicherweise weniger dringenden Handlungsbedarf. Bestätigen Sie die Pläne und den Zeitplan für Tests des App-Anbieters, aber beauftragen Sie keinen benutzerdefinierten Umbau nur, weil Shopify eine neue API veröffentlicht hat.
Halten Sie diese Migration nach Möglichkeit von einer großen Preisänderung fern. Andernfalls werden unerwartete Gesamtsummen schwerer zu diagnostizieren. Nutzen Sie ein kontrolliertes Release, wo Ihre Integration dies zulässt, und vereinbaren Sie eine Methode, um die Bearbeitung zu pausieren, während bestehende Abrechnungsvorgänge gewahrt bleiben.
Verfolgen Sie fehlgeschlagene Änderungen und Support-Kontakte bezüglich unerwarteter Verlängerungsbeträge vor und nach dem Release. Diese sind nützlichere Kennzahlen als die bloße API-Adaption. Beauftragen Sie jemanden, das Entwickler-Changelog von Shopify zusammen mit dem App-Anbieter zu prüfen, damit nachfolgende Versionsänderungen einen Verantwortlichen haben.
Wichtige Erkenntnisse
- SubscriptionContractCalculation zeigt Vertragsänderungen vor dem Speichern über die Shopify-Checkout-Engine in der Vorschau an.
- Bitten Sie Ihren Abo-Anbieter, die Regeln Ihres Shops zu demonstrieren, anstatt nur die API-Unterstützung zu bestätigen.
- Testen Sie die Vorschau gegen die gespeicherte Vereinbarung und das Abrechnungsergebnis, insbesondere bei den Cutoffs für Verlängerungen.
- Verwenden Sie das neue Webhook-Feld selling_plan_id, wo es redundante Suchvorgänge eliminiert, ohne es mit einer Vertrags-ID zu verwechseln.
Quellen
- Orders webhooks now include selling_plan_id on line items
- New SubscriptionContractCalculation API for subscription management
- Recent changes to Shopify's platform
Möchten Sie, dass wir das für Sie erledigen?
Wir sind eine Shopify Premier Agentur und das ist unsere tägliche Arbeit: Performance, CRO und Shop-Aufbauten, die sich von selbst finanzieren. Buchen Sie eine kostenlose Shop-Bewertung und wir zeigen Ihnen die drei Korrekturen, die wir zuerst umsetzen würden.
Häufig gestellte Fragen
Was ist die SubscriptionContractCalculation-API von Shopify?
Es ist eine API, die Änderungen an Abo-Verträgen über die Checkout-Engine von Shopify ausführt. Entwickler können berechnete Gesamtsummen, Lieferoptionen und Warnungen in der Vorschau anzeigen, bevor Änderungen gespeichert werden. Sie unterstützt zudem Shopify Functions während der Vertragsberechnung, einschließlich Warenkorb-Transformationen und Lieferanpassungen.
Müssen Shopify-Händler sofort von SubscriptionDraft migrieren?
Shopify empfiehlt die Migration zu SubscriptionContractCalculation, gibt aber an, dass SubscriptionDraft verfügbar bleibt. Die ältere API unterstützt die neuen Funktionen nicht. Händler sollten ihren Abo-App-Anbieter nach Implementierung und Tests fragen, anstatt anzunehmen, dass eine sofortige Änderung auf Shop-Ebene erforderlich ist.
Zeigt meine Abo-App automatisch berechnete Vorschauen an?
Die API-Ankündigung stellt nicht sicher, dass jede Abo-App die neue Funktion nutzt. Ihr Anbieter muss den Berechnungsablauf implementieren und das relevante Ergebnis in seiner Kunden- oder Mitarbeiter-Schnittstelle anzeigen. Fragen Sie nach einer Demonstration unter Verwendung der Abo-Regeln Ihres Shops.
Was bedeutet selling_plan_id in Shopify-Bestell-Webhooks?
Ab API-Version 2026-10 enthalten die Posten der Orders-Webhooks die selling_plan_id, um den angewendeten Verkaufsplan zu identifizieren. Der Wert ist null für Posten ohne Verkaufsplan. Es kann eine zusätzliche Abfrage ersetzen, ersetzt jedoch nicht den Abo-Vertrag.
