Skip to main content
Diese Seite behandelt alles Spezifische zur Verwendung von Recharge mit Subscription Upgrades. Einen vollständigen Überblick darüber, wie Subscription Upgrades funktionieren, findest du unter Subscription Upgrades.

​
Unterstützte Funktionen

Recharge 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)
  • Prepaid- und Postpaid-Frequenzen

​
Dein Recharge-API-Token generieren

  1. Melde dich in deinem Recharge-Händlerportal an.
  2. Navigiere zu Tools & Apps → API Tokens.
  3. Klicke auf Create an API Token.
  4. Gib einen Namen und eine Kontakt-E-Mail-Adresse ein.
  5. Lege die Berechtigungen fest, die Aftersell benötigt: Read and Write für Subscriptions und Read für Orders und Plans. Ein Products-Scope ist nicht erforderlich.
  6. Klicke auf Save und kopiere den API-Schlüssel.
Das Token muss alle vier Scopes besitzen: read_orders, read_subscriptions, write_subscriptions und read_plans. Aftersell prüft beim Testen des Schlüssels alle vier und benennt fehlende Scopes in der Fehlermeldung. Weitere Details findest du in der API-Dokumentation von Recharge.

​
Recharge im Einrichtungsassistenten verbinden

Wenn du Schritt 1: Connect provider im Subscription-Upgrade-Assistenten erreichst:
  1. Wähle Recharge 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 Recharge 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.

​
Ein Upgrade in Recharge überprüfen

Nachdem du eine Testbestellung aufgegeben und das Upgrade-Angebot angenommen hast: Gehe in deinem Recharge-Dashboard zu Customers, suche den Kunden und öffne Subscriptions. Das aktive Abonnement sollte die neue Frequenz, das neue Produkt oder den neuen Rabatt sofort widerspiegeln. Recharge aktualisiert nach der Annahme nahezu in Echtzeit.

​
Fehlerbehebung bei Recharge-spezifischen Problemen

Das Upgrade wurde angenommen, aber das Abonnement wurde nicht geändert Die häufigsten Ursachen:
  • Dein API-Token ist abgelaufen oder besitzt nicht die erforderlichen Berechtigungen. Das Token muss 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.
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 Recharge. Wenn das Dropdown leer ist:
  • Bestätige, dass in deinem Recharge-Dashboard Selling Plans konfiguriert sind.
  • Stelle sicher, dass dein API-Token den Scope read_plans hat.
  • Gehe zurück zu Schritt 1: Connect provider, teste deinen API-Schlüssel erneut und fahre fort.
← Zurück zum Überblick über Subscription Upgrades · Einrichtung & Konfiguration · Was sind Integrationen?