Skip to main content
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.

Obsługiwane funkcje

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)
  • Częstotliwości prepaid i postpaid

Generowanie tokenu API Recharge

  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.

Łączenie Recharge w kreatorze konfiguracji

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.

Weryfikacja ulepszenia w Recharge

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.

Rozwiązywanie problemów specyficznych dla Recharge

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 · Konfiguracja · Czym są integracje?