Skip to main content
Lösungen für die häufigsten Probleme mit Subscription Upgrades. Wenn du danach immer noch nicht weiterkommst, kontaktiere den Support mit den Angaben unter Testen und verifizieren.

​
Upgrade-Fehlschläge überwachen

Aftersell überwacht endgültige Upgrade-Fehlschläge über ein rollierendes 7-Tage-Fenster. Wenn die Anzahl der Fehlschläge die Warnschwelle überschreitet, erscheint ein Warnbanner auf deiner Startseite, das beschreibt, wie viele Upgrades über wie viele Tage fehlgeschlagen sind. Dieselbe Warnung erscheint auch im Bereich Needs attention der Startseite. Die Warnung enthält einen Button Review orders, der dich direkt zum Bestellungs-Browser bringt, gefiltert nach Subscription-Upgrade-Problemen, sodass du die betroffenen Bestellungen und die konkrete Ursache jedes Fehlschlags sehen kannst. Sie verschwindet automatisch, sobald die Anzahl der Fehlschläge innerhalb des rollierenden Fensters unter die Schwelle fällt. Wenn du diese Warnung siehst, öffne den Bestellungs-Browser, prüfe die auf jeder betroffenen Bestellung angezeigte Ursache und sieh dir dann die passenden Schritte zur Fehlerbehebung unten an.
Die Vorlage Subscription Upgrade wird nie ausgeblendet — sie ist unabhängig von deiner Anbieter-Einrichtung immer unter Add Funnel gelistet. Was dich blockiert, ist die Verbindungsprüfung in Schritt 1: Continue bleibt deaktiviert, bis Test API key ein API key verified mit grünem Haken zurückgibt.Zwei unterschiedliche Ergebnisse zeigen dasselbe rote Abbruchsymbol, lies also die Meldung daneben:
  • Dein Anbieter hat den Schlüssel abgelehnt. Dem Token fehlen erforderliche Scopes oder es wurde widerrufen, und die Meldung benennt das konkrete Problem. Stelle in deinem Anbieter-Dashboard ein neues Token mit den unter Einrichtung & Konfiguration gelisteten Scopes aus, füge es ein und teste erneut.
  • Aftersell konnte deinen Anbieter nicht erreichen — „Could not verify the API key. Please try again.“ Mit dem Token muss nichts falsch sein; der Aufruf selbst ist fehlgeschlagen. Klicke erneut auf Test API key.
Das Bearbeiten des Anbieters oder des Tokens setzt das vorherige Ergebnis zurück, teste also nach jeder Änderung erneut.
Das ist erwartetes Verhalten. Das Produkt ist das Angebotsprodukt — die Platzhalter-Position, die der Shopify-Bestellung als Nachweis des angenommenen Upgrades hinzugefügt wird. Um Verwirrung zu vermeiden, benenne das Angebotsprodukt eindeutig um und füge im Shopify Admin eine Beschreibung hinzu, die erklärt, wofür es steht. Siehe Was der Kunde sieht.
Das Shopify-Changeset und der Anbieter-API-Aufruf sind unabhängig voneinander. Wenn das Angebotsprodukt der Bestellung hinzugefügt wurde, das Abonnement aber nicht geändert wurde, sind die häufigsten Ursachen:
  • Dein Anbieter-API-Token ist abgelaufen oder besitzt nicht die erforderlichen Berechtigungen. Für Recharge muss das Token read_orders, read_subscriptions, write_subscriptions und read_plans haben. Gehe zu Schritt 1: Connect provider, teste deinen Schlüssel erneut und prüfe die Fehlermeldung auf die konkret fehlenden Scopes.
  • Das berechtigte Produkt im Funnel entspricht nicht dem, was der Kunde tatsächlich abonniert hat.
  • Bei Loop: Der Ziel-Selling-Plan existiert in deinem Loop-Dashboard nicht für die konfigurierte Frequenz.
  • Der Wiederholungs-Workflow arbeitet möglicherweise noch seinen Zeitplan ab: Nach einem fehlgeschlagenen Aufruf versucht er es erneut nach +1 Stunde und dann nach +24 Stunden. Das gilt für jeden Anbieter — auch für Loop, dessen Upgrade-Aufrufe synchron sind und bei Erfolg sofort im Dashboard erscheinen.
Aftersell wiederholt fehlgeschlagene Anbieteraufrufe automatisch in einem Hintergrund-Workflow. Der Workflow prüft vor der erneuten Ausführung den aktuellen Zustand beim Anbieter, sodass ein erfolgreiches, aber langsames Upgrade nicht doppelt angewendet wird.Wenn eine Wiederholung die Ursache nicht beheben kann, erstattet der Workflow entweder die Abbuchung — wenn keine Anbieter-Änderung erfolgreich war und die abgerechnete Position ein Platzhalter war — oder markiert das Upgrade zur manuellen Abstimmung und lässt die Bestellung unangetastet. Komplett neue Abonnements und Box-Upgrades werden nie automatisch erstattet, weil der Käufer echte Produkte erhält. Kontaktiere den Support mit den Angaben unter Testen und verifizieren.
Die Option „Use an existing selling plan“ lädt Pläne direkt aus Recharge, Skio oder Loop. Wenn das Dropdown leer ist:
  • Bestätige, dass in deinem Anbieter-Dashboard Selling Plans konfiguriert sind.
  • Stelle sicher, dass dein API-Token Lesezugriff auf Plans hat (Recharge: Scope read_plans) bzw. die passenden Scopes (Skio, Loop).
  • Gehe zurück zu Schritt 1: Connect provider, teste deinen API-Schlüssel erneut und fahre fort.
Das ist erwartetes Verhalten. Bei Loop wird das Feld Billing frequency gar nicht angezeigt — nur Delivery frequency, mit dem Hinweis „Loop syncs billing to delivery — customers are charged on each renewal“. Was du als Lieferfrequenz einstellst, ist zugleich die Abrechnungsfrequenz.Das ist auch der Grund, warum Prepaid-Abonnements — eine Abrechnungsfrequenz, die länger als die Lieferfrequenz ist — auf Loop nicht unterstützt werden: Die Integration lehnt sie direkt ab, statt ein Feld anzubieten, das du nicht verwenden kannst. Die anderen Anbieter zeigen beide Felder.
Das Angebotsprodukt ist ein reines Abonnementprodukt — entweder das Produkt selbst oder jede seiner Varianten — und der Checkout des Kunden enthielt bereits ein Abonnement. Shopify erlaubt kein zweites Abonnement auf derselben Bestellung, daher wurde das Angebot übersprungen.Das Bestelldetail-Panel benennt den konkreten Fall: „The customer’s checkout already has a subscription, and the offer product is subscription-only“ oder „All variants of the offer product are subscriptions, and the customer’s checkout already has one.“ Beide werden auf dieselbe Weise behoben — bearbeite die Produktauswahl des Angebots und tausche ein Einmalkauf-Produkt ein, oder nutze die Option Create new in Schritt 4: Offer product, um einen Platzhalter zu generieren.
  • Prüfe, dass Show this funnel for all customers nicht aktiviert ist. Diese Einstellung überschreibt alle anderen Trigger.
  • Prüfe den Trigger Variant on subscription. Er zeigt den Funnel nur, wenn die Bestellung eines der ausgewählten Produkte als Abonnement gekauft enthält. Bei einem Funnel mit einem Subscription-Upgrade-Angebot verwaltet der Assistent diesen Trigger und hält ihn synchron mit dem upzugradenden Produkt, er ist also schreibgeschützt — das Panel zeigt „Managed by this funnel’s subscription upgrade offer.“ Wenn er auf die falschen Produkte abzielt, korrigiere das Trigger-Produkt des Upgrade-Angebots statt des Triggers selbst.
  • Prüfe die Funnel-Priorität. Ein Funnel mit höherer Priorität und breiteren Triggern könnte zuerst ausgelöst werden.
Versuche nicht, das mit einem separaten Product-Trigger plus einem Subscription-Trigger nachzubauen. Genau diese Kombination wurde durch Variant on subscription ersetzt: Die beiden trafen unabhängig voneinander zu, sodass eine Bestellung mit deinem Trigger-Produkt als Einmalkauf und einem anderen Abonnement-Artikel beide erfüllte, den Funnel auslöste und das Upgrade dann später fehlschlug. Ein einzelner Trigger, der Produkt und Abonnement-Status gemeinsam abgleicht, ist die unterstützte Einrichtung.