> ## 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.

# Ulepszenia subskrypcji z Recharge

> Przewodnik krok po kroku dotyczący łączenia Recharge i konfigurowania ulepszeń subskrypcji (Subscription Upgrades) w Aftersell.

Ta strona opisuje wszystko, co dotyczy korzystania z **Recharge** z ulepszeniami subskrypcji (Subscription Upgrades). Pełny przegląd działania ulepszeń subskrypcji znajdziesz w artykule [Ulepszenia subskrypcji](/pl/aftersell/subscription-upgrades).

<div id="supported-features">
  ## Obsługiwane funkcje
</div>

Recharge obsługuje wszystkie typy ulepszeń subskrypcji:

* Zmiana częstotliwości dostaw lub rozliczeń
* Zamiana na inny produkt
* Oba – zmiana częstotliwości i zamiana produktu
* Dodanie kolejnego produktu subskrybowalnego do subskrypcji (zobacz [Dodawanie produktu](/pl/aftersell/subscription-upgrades-add-item))
* Częstotliwości prepaid i postpaid

<div id="generating-your-recharge-api-token">
  ## Generowanie tokenu API Recharge
</div>

1. Zaloguj się do portalu sprzedawcy Recharge.
2. Przejdź do **Tools & Apps → API Tokens**.
3. Kliknij **Create an API Token**.
4. Wprowadź nazwę i kontaktowy adres e-mail.
5. Ustaw uprawnienia, których potrzebuje Aftersell: **Read and Write** dla Subscriptions oraz **Read** dla Orders i Plans. Zakres Products nie jest wymagany.
6. Kliknij **Save** i skopiuj klucz API.

Token musi posiadać wszystkie cztery zakresy: `read_orders`, `read_subscriptions`, `write_subscriptions` oraz `read_plans`. Aftersell sprawdza wszystkie cztery podczas testu klucza i wymienia brakujące w komunikacie błędu.

Więcej szczegółów znajdziesz w [dokumentacji API Recharge](https://docs.rechargepayments.com/).

<div id="connecting-recharge-in-the-setup-wizard">
  ## Łączenie Recharge w kreatorze konfiguracji
</div>

Gdy dotrzesz do **Kroku 1: Połącz dostawcę** w kreatorze ulepszeń subskrypcji:

1. Wybierz **Recharge** z listy rozwijanej **Subscription provider**.
2. Wklej swój token API w pole **API token**.
3. Kliknij **Test API key**. Aftersell zweryfikuje token, sprawdzając, czy uwierzytelnia się poprawnie, posiada wszystkie wymagane zakresy uprawnień i należy do Twojego sklepu.
4. Gdy test zakończy się pomyślnie (zielony znacznik), kliknij **Continue**, aby przejść do Kroku 2.

Wynik testu pokazuje jeden z dwóch stanów:

* **Zielony znacznik — „API key verified”.** Token został uwierzytelniony, wszystkie wymagane zakresy uprawnień są obecne, a token należy do Twojego sklepu. Przycisk **Continue** jest teraz aktywny.
* **Czerwona ikona anulowania.** Weryfikacja nie przebiegła pomyślnie. Przeczytaj komunikat obok ikony: albo token został odrzucony lub brakuje mu wymaganych zakresów uprawnień — komunikat wymienia konkretne brakujące zakresy; popraw token w Recharge i przetestuj ponownie. Albo Aftersell nie mógł ukończyć weryfikacji („Could not verify the API key. Please try again.”), co oznacza nieudane wywołanie, a nie zły token — w takim przypadku po prostu przetestuj ponownie.

Wynik „nie można zweryfikować” wygląda dokładnie jak odrzucenie, więc kieruj się komunikatem, a nie ikoną. Przycisk **Continue** pozostaje nieaktywny, dopóki weryfikacja nie zakończy się na zielono, a edycja dostawcy lub tokenu czyści poprzedni wynik.

<div id="verifying-an-upgrade-in-recharge">
  ## Weryfikacja ulepszenia w Recharge
</div>

Po złożeniu zamówienia testowego i zaakceptowaniu oferty ulepszenia:

Przejdź do **Customers** w panelu Recharge, znajdź klienta i otwórz **Subscriptions**. Aktywna subskrypcja powinna natychmiast odzwierciedlać nową częstotliwość, produkt lub rabat.

Recharge aktualizuje dane niemal w czasie rzeczywistym po akceptacji.

<div id="troubleshooting-recharge-specific-issues">
  ## Rozwiązywanie problemów specyficznych dla Recharge
</div>

**Ulepszenie zostało zaakceptowane, ale subskrypcja nie została zmodyfikowana**

Najczęstsze przyczyny:

* Twój token API wygasł lub brakuje mu wymaganych uprawnień. Token musi mieć zakresy `read_orders`, `read_subscriptions`, `write_subscriptions` i `read_plans`. Przejdź do **Kroku 1: Połącz dostawcę**, ponownie przetestuj klucz i sprawdź w komunikacie błędu konkretne brakujące zakresy.
* Kwalifikujący się produkt w lejku nie odpowiada temu, co klient faktycznie subskrybował.

Aftersell automatycznie ponawia nieudane wywołania dostawcy w procesie działającym w tle. Jeśli wszystkie ponowienia się nie powiodą, skontaktuj się z pomocą techniczną, podając adres URL sklepu, identyfikator zamówienia Shopify, adres e-mail klienta, przybliżony czas zaakceptowania ulepszenia oraz używanego dostawcę.

**Lista rozwijana planów sprzedaży jest pusta**

Opcja „Use an existing selling plan” pobiera plany bezpośrednio z Recharge. Jeśli lista jest pusta:

* Potwierdź, że plany sprzedaży są skonfigurowane w panelu Recharge.
* Upewnij się, że Twój token API ma zakres `read_plans`.
* Wróć do **Kroku 1: Połącz dostawcę**, ponownie przetestuj token API i kontynuuj.

***

← Wróć do [Przeglądu ulepszeń subskrypcji](/pl/aftersell/subscription-upgrades) · [Konfiguracja](/pl/aftersell/subscription-upgrades-setup) · [Czym są integracje?](/pl/aftersell/subscription-upgrades-integrations)