Skip to main content
Diese Seite behandelt alles Spezifische zur Verwendung von Stay AI 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

Stay AI unterstützt alle Subscription-Upgrade-Typen:
  • Liefer- oder Abrechnungsfrequenz ändern (wird auf das gesamte Abonnement angewendet)
  • Durch ein anderes Produkt ersetzen
  • Beides - Frequenz ändern und Produkt ersetzen
  • Einen weiteren abonnierbaren Artikel zum Abonnement hinzufügen (siehe Artikel hinzufügen). Wenn der Kunde dieses Produkt bereits abonniert hat, erhöht Stay stattdessen dessen Menge, statt eine neue Position hinzuzufügen (dafür gilt eine Preisübereinstimmungsbedingung - siehe die Einschränkungen unten).
  • Postpaid-Frequenzen (Bezahlung pro Lieferung), einschließlich der Umstellung eines Postpaid-Abonnements auf einen Plan mit Vorauszahlung (unter den unten genannten Bedingungen)
Produkttausch wird unterstützt, außer auf ein Produkt, das nur mit Vorauszahlungsplänen verkauft wird - siehe die Prepaid-Einschränkung unten.

​
Ein Abonnement auf einen Plan mit Vorauszahlung umstellen

Die Umstellung eines Postpaid-Abonnements auf einen Plan mit Vorauszahlung (Prepaid) wird unterstützt, unter zwei Bedingungen:
  • Der Vorauszahlungsplan muss in Stay AI bereits existieren und dem Produkt zugewiesen sein. Aftersell kann keinen erstellen; im Angebot kannst du nur aus Plänen wählen, die in Stay AI bereits eingerichtet sind.
  • Die Umstellung erstellt ein neues Abonnement und kündigt das alte. Stay nimmt diese Änderung vor, indem es ein neues Abonnement auf dem Vorauszahlungsplan erstellt und das ursprüngliche kündigt, sodass das Abonnement eine neue Referenz erhält. Lager-, 3PL- oder Reporting-Tools, die Abonnements anhand ihrer Referenz verfolgen, müssen neu synchronisiert werden. Siehe Fulfillment & 3PL-Zuordnung.

​
Stay AI-spezifische Einschränkungen

  • Prepaid-Abonnements (Vorauszahlung) können nicht geändert werden. Stay erlaubt keinerlei Änderung an einem Abonnement, das der Kunde im Voraus bezahlt hat, unabhängig vom Upgrade-Typ. Wenn ein Kunde mit einem Prepaid-Plan ein Upgrade-Angebot annimmt, wird das Upgrade storniert und ihm der Betrag erstattet, sodass das Abonnement unverändert bleibt. Aus demselben Grund kannst du ein Abonnement nicht auf ein Produkt umstellen, das nur mit Vorauszahlungsplänen verkauft wird.
  • Kündigungen sind auf eine App pro Konto beschränkt. Stay sendet Kündigungsupdates nur an eine App pro Konto. Wenn sich eine andere App oder Integration vor Aftersell für den Kündigungs-Webhook von Stay registriert hat, kann Aftersell diese Updates nicht empfangen, und das Diagramm Subscriptions cancelled bildet Stay-Kündigungen nicht ab. Der API-Key, den du verbindest, muss die Berechtigung Webhooks enthalten (siehe unten), damit die Kündigungsverfolgung überhaupt funktioniert.
  • Eine Frequenzänderung gilt für das gesamte Abonnement. Stay hat einen Zeitplan pro Abonnement, daher verschiebt eine Änderung des Lieferrhythmus jedes darin enthaltene Produkt. Wenn das Abonnement zwei oder mehr Produkte enthält, musst du am Angebot Keep on existing subscription aktivieren; andernfalls wird das Frequenz-Upgrade abgelehnt und dem Kunden der Betrag erstattet. Das ist nur für Frequenzänderungen nötig - Produkttausch und Add-ons sind nicht betroffen und funktionieren ohne diese Einstellung.
  • Mehr von einem bereits abonnierten Produkt hinzuzufügen erfordert einen übereinstimmenden Preis. Wenn das Add-on ein Produkt ist, das der Kunde bereits hat, erhöht Stay dessen Menge, statt eine Position hinzuzufügen - aber nur, wenn der Preis des Angebots dem entspricht, was der Kunde bereits dafür bezahlt. Wenn die Preise abweichen (zum Beispiel bietet das Add-on 20 % Rabatt, während sein Plan 10 % Rabatt hat), wird das Upgrade abgelehnt und das Abonnement bleibt unverändert. Gib dem Add-on denselben Rabatt wie dem Plan des Kunden oder biete ein anderes Produkt an (ein anderes Produkt ist nicht betroffen).
  • Die Währung muss der Preisgestaltung deines Shops entsprechen. Wenn das Abonnement des Kunden in einer Währung abgerechnet wird, in der dein Shop keine Preise führt, wird das Upgrade abgelehnt.
  • Doppelte Abonnements aus einer Bestellung können nicht unterschieden werden. Wenn eine einzelne Bestellung zwei Stay-Abonnements gestartet hat, die beide das Produkt des Angebots enthalten, kann Aftersell nicht erkennen, welches der Kunde gemeint hat, und das Upgrade wird abgelehnt, statt auf den falschen Vertrag angewendet zu werden.
  • Rate Limits begrenzen den Durchsatz. Stay erlaubt 60 Anfragen pro Minute und Konto. Ein Upgrade benötigt vier bis sechs Anfragen, daher kommt ein Shop in Spitzenzeiten auf höchstens etwa 10 bis 15 Upgrades pro Minute.

​
Deinen Stay AI-API-Key generieren

  1. Gehe in deinem Stay AI-Dashboard zu Account → API tokens → Add API key.
  2. Wähle beim Erstellen des Keys All permissions. Aftersell benötigt Zugriff auf Subscriptions, Orders, Selling Plan Groups und Webhooks. Die Berechtigung Webhooks ermöglicht es Aftersell, über Kündigungen informiert zu werden.
  3. Kopiere den Key und bewahre ihn sicher auf. Behandle ihn wie ein Passwort.
Weitere Details findest du in der API-Authentifizierungsdokumentation von Stay AI.

​
Stay AI im Einrichtungsassistenten verbinden

Wenn du Schritt 1: Connect provider im Subscription-Upgrade-Assistenten erreichst:
  1. Wähle Stay AI im Dropdown Subscription provider.
  2. Füge deinen API-Key in das Feld API key ein.
  3. Klicke auf Test API key. Aftersell validiert den Key und prüft, ob er sich korrekt authentifiziert 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“. Der Key wurde authentifiziert und gehört zu deinem Shop. Continue ist jetzt aktiviert. Wenn dem Key die Berechtigung Webhooks fehlt, wird der Test trotzdem bestanden, warnt aber, dass Abonnementkündigungen nicht erfasst werden - erstelle den Key in Stay AI mit All permissions neu, wenn du Kündigungen verfolgen möchtest.
  • Rotes Abbruchsymbol. Die Prüfung war nicht sauber. Lies die Meldung neben dem Symbol: Entweder wurde der Key abgelehnt, 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ültiger Key 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 Keys setzt das vorherige Ergebnis zurück.

​
Ein Upgrade in Stay AI überprüfen

Nachdem du eine Testbestellung aufgegeben und das Upgrade-Angebot angenommen hast: Gehe in deinem Stay AI-Dashboard zu Subscriptions und suche das Abonnement des Kunden. Abrechnungsfrequenz, Produkt oder nächstes Abbuchungsdatum sollten die Änderung widerspiegeln. Die Änderung selbst wird angewendet, sobald Aftersell die Annahme verarbeitet, aber Stay kann eine brandneue Bestellung nur langsam übernehmen: Das Upgrade kommt meist innerhalb weniger Minuten an, in den langsamsten Fällen nach bis zu 24 Stunden. Wenn die Änderung noch nicht da ist, warte etwas, bevor du es als Fehlschlag wertest.

​
Wenn ein Upgrade nicht angewendet werden kann

Stay AI-Upgrades sind von Grund auf sicher - einem Kunden wird nie ein Upgrade berechnet, das nicht stattgefunden hat:
  • Fehlgeschlagene Upgrades werden automatisch wiederholt. Wenn ein Aufruf an Stay AI fehlschlägt, wiederholt Aftersell ihn in einem Hintergrund-Workflow.
  • Kann es trotzdem nicht angewendet werden, erhält der Kunde eine Erstattung. Ein Subscription Upgrade berechnet in der Shopify-Bestellung nur eine kleine Platzhalter-Position (kein Produkt, das der Kunde behält), daher erstattet Aftersell diese Abbuchung, wenn das Upgrade nicht abgeschlossen werden kann.
  • Alles, was nicht bestätigt werden kann, wird zur manuellen Prüfung markiert, statt geraten zu werden, sodass einem Kunden nie ein Upgrade berechnet wird, das nicht stattgefunden hat.
Die vollständige Mechanik für Wiederholungen und Abgleich (für alle Anbieter gleich) findest du unter Wie Subscription Upgrades funktionieren.

​
Fehlerbehebung bei Stay AI-spezifischen Problemen

Das Upgrade wurde angenommen, aber das Abonnement wurde nicht geändert Die häufigsten Ursachen:
  • Der Kunde hat einen Prepaid-Plan (Vorauszahlung). Stay erlaubt keine Änderung von Prepaid-Verträgen, daher wird das Upgrade storniert und erstattet. Das ist erwartetes Verhalten.
  • Das Abonnement wird in einer Währung abgerechnet, in der dein Shop keine Preise führt, daher wurde das Upgrade abgelehnt.
  • Das Abonnement hat zwei oder mehr Produkte und du hast die Frequenz geändert, ohne Keep on existing subscription zu aktivieren.
  • Eine Bestellung hat zwei Stay-Abonnements gestartet, die beide das Produkt des Angebots enthalten, daher konnte Aftersell nicht erkennen, welches upgegradet werden soll.
  • Dein API-Key stammt aus einem anderen Shop oder es fehlt ihm eine erforderliche Berechtigung (Subscriptions, Orders oder Selling Plan Groups). Erstelle den Key in Stay AI neu oder wähle ihn erneut aus, gehe zu Schritt 1: Connect provider und teste ihn erneut.
  • 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 Upgrade-Annahme und dem verwendeten Anbieter. Stay-Kündigungen werden in den Analytics nicht angezeigt Stay sendet Kündigungsupdates nur an eine App pro Konto. Wenn sich eine andere App vor Aftersell für den Kündigungs-Webhook von Stay registriert hat, kann Aftersell sie nicht empfangen. Stelle sicher, dass keine andere Integration den Kündigungs-Webhook von Stay belegt, und dass der verbundene API-Key die Berechtigung Webhooks enthält.
← Zurück zum Überblick über Subscription Upgrades · Einrichtung & Konfiguration · Was sind Integrationen?