> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aftersell.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Subscription Upgrades mit Recharge

> Schritt-für-Schritt-Anleitung zum Verbinden von Recharge und Einrichten von Subscription Upgrades in Aftersell.

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](/de/aftersell/subscription-upgrades).

<div id="supported-features">
  ## Unterstützte Funktionen
</div>

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](/de/aftersell/subscription-upgrades-add-item))
* Prepaid- und Postpaid-Frequenzen

<div id="generating-your-recharge-api-token">
  ## Dein Recharge-API-Token generieren
</div>

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](https://docs.rechargepayments.com/).

<div id="connecting-recharge-in-the-setup-wizard">
  ## Recharge im Einrichtungsassistenten verbinden
</div>

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.

<div id="verifying-an-upgrade-in-recharge">
  ## Ein Upgrade in Recharge überprüfen
</div>

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.

<div id="troubleshooting-recharge-specific-issues">
  ## Fehlerbehebung bei Recharge-spezifischen Problemen
</div>

**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](/de/aftersell/subscription-upgrades) · [Einrichtung & Konfiguration](/de/aftersell/subscription-upgrades-setup) · [Was sind Integrationen?](/de/aftersell/subscription-upgrades-integrations)