Skip to main content
Diese Seite behandelt alles Spezifische zur Verwendung von Loop mit Subscription Upgrades, einschließlich seiner besonderen Einschränkungen. Einen vollständigen Überblick darüber, wie Subscription Upgrades funktionieren, findest du unter Subscription Upgrades.

​
Unterstützte Funktionen

Loop unterstützt alle Subscription-Upgrade-Typen:
  • Liefer- oder Abrechnungsfrequenz ändern
  • Durch ein anderes Produkt ersetzen
  • Beides – Frequenz ändern und Produkt ersetzen
  • Einen weiteren abonnierbaren Artikel zum Abonnement hinzufügen (siehe Artikel hinzufügen)
  • Nur Postpaid-Frequenzen (Prepaid wird nicht unterstützt — siehe Einschränkungen unten)

​
Loop-spezifische Einschränkungen

  • Die Abrechnungsfrequenz muss der Lieferfrequenz entsprechen. Loop unterstützt über diese Integration keine Prepaid-Abonnements. Das Feld für die Abrechnungsfrequenz ist deaktiviert und wird automatisch mit der Lieferfrequenz synchronisiert. Dies ist die größte Einschränkung, die du beachten solltest, wenn dein Shop auf Prepaid-Pläne setzt.
  • Abonnements mit mehreren Positionen werden in zwei Schritten verarbeitet: Die Zielproduktposition wird in ein neues Abonnement mit der gewünschten Frequenz abgespalten und dann aus dem ursprünglichen entfernt. Das erfordert mehrere API-Aufrufe und kann während des Sync-Fensters vorübergehende In-Progress-Positionen in deinem Loop-Dashboard anzeigen.
  • Eine benutzerdefinierte Frequenz wird für Abonnements mit mehreren Positionen nicht unterstützt. Wenn du die Frequenz manuell festlegst (ohne einen Selling Plan auszuwählen), funktioniert das Upgrade für Kunden, deren Abonnement eine einzige Produktposition enthält. Bei Kunden mit einem Multi-Produkt- oder Bundle-Abonnement (zwei oder mehr aktive Positionen) schlägt das Upgrade fehl, wenn für die Zielfrequenz kein passender Selling Plan existiert. Um diese Kunden zu unterstützen, erstelle den entsprechenden Selling Plan in deinem Loop-Dashboard.

​
Dein Loop-API-Token generieren

  1. Öffne die Loop-App und navigiere unten links zu Settings.
  2. Klicke unter Admin auf API Tokens.
  3. Lege die Berechtigungen fest, die Aftersell benötigt: Read and Write für Subscription contracts und Read für Orders und Selling plans. Schreibzugriff ist nur für Abonnements erforderlich.
  4. Klicke auf Generate New Token.
  5. Gib einen Namen ein, wähle die passenden Scopes und klicke auf Generate Token.
  6. Klicke auf Show Token, um deinen Schlüssel anzuzeigen und zu kopieren. Behandle ihn wie ein Passwort und bewahre ihn sicher auf.
Weitere Details findest du in der API-Dokumentation von Loop.

​
Loop im Einrichtungsassistenten verbinden

Wenn du Schritt 1: Connect provider im Subscription-Upgrade-Assistenten erreichst:
  1. Wähle Loop im Dropdown Subscription provider.
  2. Füge dein API-Token in das Feld API token ein.
  3. Klicke auf Test API key. Aftersell validiert das Token und prüft, ob es sich korrekt authentifiziert, alle erforderlichen Scopes besitzt und zu deinem Shop gehört.
  4. Sobald der Test bestanden ist (grüner Haken), klicke auf Continue, um zu Schritt 2 zu gelangen.
Das Testergebnis zeigt einen von zwei Zuständen:
  • Grüner Haken — „API key verified“. Das Token wurde authentifiziert, alle erforderlichen Scopes sind vorhanden und das Token gehört zu deinem Shop. Continue ist jetzt aktiviert.
  • Rotes Abbruchsymbol. Die Prüfung war nicht sauber. Lies die Meldung neben dem Symbol: Entweder wurde das Token abgelehnt oder es fehlen erforderliche Scopes. Die Meldung benennt die konkret fehlenden Scopes. Korrigiere das Token in Loop und teste erneut. Oder Aftersell konnte die Prüfung nicht abschließen („Could not verify the API key. Please try again.“), was ein fehlgeschlagener Aufruf und kein ungültiges Token ist — in dem Fall teste einfach erneut.
Ein Could-not-verify-Ergebnis sieht genauso aus wie eine Ablehnung, richte dich also nach der Meldung und nicht nach dem Symbol. Continue bleibt deaktiviert, bis die Prüfung grün zurückkommt, und das Bearbeiten des Anbieters oder des Tokens setzt das vorherige Ergebnis zurück.

​
Bevor du das Upgrade konfigurierst (Schritt 3)

Beim Konfigurieren einer Frequenzänderung kannst du entweder einen bestehenden Selling Plan auswählen oder die Frequenz manuell festlegen:
  • Einen bestehenden Selling Plan verwenden. Wähle aus dem Selling-Plan-Dropdown. Der Plan muss in deinem Loop-Dashboard bereits existieren und aktiv sein.
  • Die Frequenz manuell festlegen. Gib die Lieferfrequenz selbst ein. Loop akzeptiert jeden Rhythmus, ohne einen passenden Selling Plan zu verlangen. Bei manueller Frequenz kannst du außerdem einen wiederkehrenden Rabatt anwenden.
Wenn du die Frequenz manuell festlegst und das Abonnement des Kunden zwei oder mehr aktive Produktpositionen hat (ein Multi-Produkt- oder Bundle-Vertrag), schlägt das Upgrade fehl, sofern für die Zielfrequenz kein passender Selling Plan existiert. Details findest du unter Einschränkungen.

​
Eine wiederkehrende Rabattstufe auswählen

Manche Loop-Selling-Plans wenden zu verschiedenen Zeitpunkten des Abonnements unterschiedliche Rabatte an — zum Beispiel $20 Rabatt auf die erste Abbuchung und $10 Rabatt ab der zweiten Abbuchung. Wenn du einen solchen Plan auswählst, wird das Feld Recurring discount durch eine Liste von Optionsfeldern ersetzt, die jede Rabattstufe des Plans mit ihrem Abbuchungsbereich anzeigen (zum Beispiel „Charge 1“ oder „Charge 2 onward“). Wähle die Stufe aus, die auf jede zukünftige Verlängerung des upgegradeten Abonnements angewendet werden soll. Die ausgewählte Stufe wird mit dem Angebot gespeichert und angewendet, wenn ein Kunde das Upgrade annimmt. Wenn der ausgewählte Plan keine Rabattstufen hat oder du die Frequenz manuell festlegst, erscheint stattdessen das übliche Freitextfeld für den Rabatt.

​
Ein Upgrade in Loop überprüfen

Nachdem du eine Testbestellung aufgegeben und das Upgrade-Angebot angenommen hast: Gehe in deinem Loop-Dashboard zu Subscriptions und suche das Abonnement des Kunden. Loops Upgrade-Aufrufe sind synchron, es gibt also keine Verarbeitungsverzögerung auf Aftersell-Seite — die Änderung wird bei Loop angewendet, sobald der Aufruf zurückkehrt. Loops eigene Abonnement-Liste kann etwas länger brauchen, um nachzuziehen. Wenn die Änderung also noch nicht da ist, warte ein paar Minuten und aktualisiere die Seite, bevor du es als Fehlschlag wertest. Wenn die Änderung nicht da ist, ist sie nicht angekommen — siehe unten.

​
Fehlerbehebung bei Loop-spezifischen Problemen

Ich kann die Abrechnungsfrequenz nicht ändern Das ist erwartetes Verhalten. Loop unterstützt über diese Integration keine Prepaid-Abonnements. Das Feld für die Abrechnungsfrequenz ist deaktiviert und wird automatisch mit der Lieferfrequenz synchronisiert. Das Upgrade wurde angenommen, aber das Abonnement wurde nicht geändert Wenn das Abonnement unverändert ist, sind die häufigsten Ursachen:
  • Du hast die Frequenz manuell festgelegt und das Abonnement des Kunden hat zwei oder mehr aktive Produktpositionen. In diesem Fall verlangt Loop einen passenden Selling Plan für die Zielfrequenz. Erstelle den Selling Plan in Loop oder wechsle in der Angebotskonfiguration zu Use an existing selling plan.
  • Du hast Use an existing selling plan verwendet und der ausgewählte Selling Plan existiert nicht mehr in deinem Loop-Dashboard. Erstelle den Selling Plan in Loop und versuche es erneut.
  • Dein API-Token ist abgelaufen oder besitzt nicht die erforderlichen Berechtigungen: write für Subscription contracts, read für Orders und Selling plans. 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.
Aftersell wiederholt fehlgeschlagene Anbieteraufrufe automatisch in einem Hintergrund-Workflow. Wenn alle Wiederholungen fehlschlagen, kontaktiere den Support mit deiner Shop-URL, der Shopify-Bestell-ID, der E-Mail-Adresse des Kunden, dem ungefähren Zeitpunkt der Angebotsannahme und dem verwendeten Anbieter. Das Selling-Plan-Dropdown ist leer Die Option „Use an existing selling plan“ lädt Pläne direkt aus Loop. Wenn das Dropdown leer ist:
  • Bestätige, dass in deinem Loop-Dashboard Selling Plans konfiguriert sind.
  • Stelle sicher, dass dein API-Token Read-Zugriff auf Selling plans hat.
  • Gehe zurück zu Schritt 1: Connect provider, teste deinen API-Schlüssel erneut und fahre fort.
In meinem Loop-Dashboard erscheinen vorübergehende In-Progress-Positionen Das ist bei Abonnements mit mehreren Positionen erwartetes Verhalten. Loop verarbeitet sie in zwei Schritten (abspalten, dann entfernen), sodass zwischen den beiden Schritten eine vorübergehende Position erscheinen kann. Sie verschwindet, sobald der zweite Schritt abgeschlossen ist.
← Zurück zum Überblick über Subscription Upgrades · Einrichtung & Konfiguration · Was sind Integrationen?