Abo-Preis in Shopify Checkout UI Extensions

Eine Shopify Checkout-UI-Extension kann den wiederkehrenden Preis, den ein Abonnent an der Kasse sieht, nicht überschreiben. Diese Zahl stammt aus der Pricing Policy des Selling Plans. Wenn sie nach einem Produktwechsel falsch aussieht, gehört die Korrektur zum Plan, nicht zur Extension.

Ein Händler mit einem Kerzen-Abo berichtete, dass das Recurring Subtotal dauerhaft den Startpreis zeigte, selbst nachdem Kunden auf eine günstigere Nachfüll-Variante gewechselt waren, wie in einem Shopify-Community-Thread beschrieben. Wir sehen die gleiche Verwirrung in unserer eigenen Support-Warteschlange: 13 Fragen zum Abo-Checkout in 90 Tagen, darunter Händler, die unsicher sind, was die Kasse verspricht und was tatsächlich abgerechnet wird.

Woher der wiederkehrende Preis wirklich kommt

Shopify ordnet Abo-Produkte in Selling Plan Groups. Jeder Plan hat eine Pricing Policy, und diese Policy hat zwei Formen: fixed, eine einzige Anpassung für das gesamte Abo, oder recurring, eine andere Anpassung nach Ablauf einer Anfangsperiode. Die Kasse liest direkt aus der Policy, die an dieser Position hängt.

Checkout-UI-Extensions stehen neben dieser Zahl, nicht darin. Shopify dokumentiert sie als Blöcke oder statische Inhalte, die vor oder nach Checkout-Abschnitten platziert werden. Die Preisberechnung übernimmt separat Shopify Functions, nicht eine UI-Extension.

Wenn du deine Checkout- und Konto-Extensions seit der letzten Frist noch nicht geprüft hast, ist das ein guter Ausgangspunkt, bevor du eine weitere hinzufügst.

Zwei Dinge, die Leute "Produktwechsel" nennen

Trenne diese beiden Fälle, bevor du mit der Fehlersuche beginnst: einen in den Plan eingebauten Zykluswechsel, etwa Kerzen-Startpreis dann Nachfüllpreis ohne Kundenaktion, und einen manuellen Produktwechsel durch den Käufer mitten im Abo. Der oben genannte Forenfall ist die erste Art. Ein manueller Wechsel ist eine andere Aktion, aktualisiert aber dasselbe Pricing-Policy-Objekt darunter.

Das Audit: herausfinden, was kaputt ist

1. Hole den Selling Plan hinter dem Produkt, aus dem Dashboard deiner Abo-App oder über die Admin-GraphQL-Abfrage sellingPlanGroups, und sieh dir seine Pricing Policies an.
2. Prüfe, ob er eine Policy oder zwei hat. Nur eine Policy bedeutet, dass beide Zyklen absichtlich dieselbe Zahl anzeigen und abrechnen.
3. Wenn du zwei Preise erwartest, füge die fehlende recurring Policy über deine Abo-App hinzu, sodass Zyklus eins den Startpreis abrechnet und spätere Zyklen den Wechselpreis.
4. Speichere die Änderung, platziere eine echte Test-Abo-Bestellung und prüfe deren erste anstehende Belastung in deiner Abo-App, bevor du jemandem sagst, das Problem sei gelöst.
5. Wenn beide Policies bereits korrekt sind und die Kasse trotzdem unklar wirkt, ist das ein Formulierungsproblem, kein Preisproblem. Gehe zum nächsten Abschnitt, statt den Plan erneut zu bearbeiten.

Warum sich die Korrektur vor der nächsten Migration lohnt

Ein Abonnent, der an der Kasse einen Preis sieht und auf der Abrechnung einen anderen, kündigt häufig oder meldet eine Rückbuchung. Das zeigt sich oft genau dann, wenn Shops die Abo-App wechseln.

Wir haben auch Support-Tickets gesehen, bei denen Zahlungsmethoden unabhängig von der Preisgestaltung ausfielen, etwa eine Frage zu "iDEAL/Mollie payments not working" nach einem Anbieterwechsel. Das ist ein eigener Fehler, den man separat prüfen sollte.

Wenn du abwägst, ob sich eine Migration überhaupt lohnt, zeigt unsere Aufschlüsselung der Abo-Kosten die Gebühren, die die meisten Shops übersehen.

Wenn die Zahl stimmt, aber der Text nicht

Apps, die auf dem nativen Pricing-Modell von Shopify aufbauen, speichern einen Wechsel genauso wie Shopify selbst. Progus Subscriptions etwa hält die Pricing Policies jedes Plans als Paare aus Adjustment-Type und Adjustment-Value, dasselbe Objekt, aus dem die Kasse liest, sodass das obige Audit unabhängig davon funktioniert, welche App das Abo verwaltet.

Wenn der abgerechnete Betrag bereits korrekt ist und du nur zusätzlichen Kontext vor dem Wechsel möchtest, kann ein Entwickler eine Checkout-UI-Extension in der Nähe der Bestellübersicht hinzufügen. Sie kann einen gespeicherten zukünftigen Preis aus einem Metafield lesen und als Hinweis anzeigen. Dieser Hinweis ändert nicht die Recurring-Subtotal-Zeile, er beantwortet nur die Frage daneben.

Shopify beschränkt Checkout-UI-Extensions auf den Schritten Informationen, Versand und Zahlung auf Shops mit Shopify Plus. Extensions in der Nähe der Bestellübersicht folgen einem anderen Target Type, also bestätige deine genaue Platzierung, bevor du das jemandem versprichst.

Fazit

Checkout-UI-Extensions sind eine Präsentationsschicht, kein Preismodul. Wenn eine Zahl falsch aussieht, prüfe zuerst die Pricing Policy des Selling Plans und baue erst dann eine eigene Extension, wenn der abgerechnete Betrag selbst bestätigt korrekt ist.

Abo-Apps ändern sich durch Übernahmen, Migrationen und Anbieter, die Funktionen einstellen, häufiger als die meisten Händler erwarten. Teste die Pricing Policy und die Konfiguration der Zahlungsmethode nach solchen Ereignissen getrennt, denn eines kann ausfallen, ohne dass das andere betroffen ist.