Skip to main content
Ta strona opisuje wszystko, co dotyczy korzystania ze Stay AI z ulepszeniami subskrypcji (Subscription Upgrades), w tym jego unikalne ograniczenia. Pełny przegląd działania ulepszeń subskrypcji znajdziesz w artykule Ulepszenia subskrypcji.

Obsługiwane funkcje

Stay AI obsługuje wszystkie typy ulepszeń subskrypcji:
  • Zmiana częstotliwości dostaw lub rozliczeń (stosowana do całej subskrypcji)
  • Zamiana na inny produkt
  • Oba - zmiana częstotliwości i zamiana produktu
  • Dodanie kolejnego produktu subskrybowalnego do subskrypcji (zobacz Dodawanie produktu). Jeśli klient już subskrybuje ten produkt, Stay zwiększa jego ilość zamiast dodawać nową pozycję (obowiązuje tu warunek zgodności ceny - zobacz ograniczenia poniżej).
  • Częstotliwości postpaid (płatność przy każdej dostawie), w tym przeniesienie subskrypcji postpaid na plan z płatnością z góry (z warunkami opisanymi poniżej)
Zamiana produktu jest obsługiwana z wyjątkiem zamiany na produkt sprzedawany wyłącznie w planach z płatnością z góry - zobacz ograniczenie dotyczące prepaid poniżej.

Przeniesienie subskrypcji na plan z płatnością z góry

Przełączenie subskrypcji postpaid na plan z płatnością z góry (prepaid) jest obsługiwane pod dwoma warunkami:
  • Plan z płatnością z góry musi już istnieć w Stay AI i być przypisany do produktu. Aftersell nie może go utworzyć; oferta pozwala wybierać tylko spośród planów już skonfigurowanych w Stay AI.
  • Przeniesienie tworzy nową subskrypcję i anuluje starą. Stay wprowadza tę zmianę, tworząc nową subskrypcję w planie z płatnością z góry i anulując pierwotną, więc subskrypcja otrzymuje nowy identyfikator. Narzędzia magazynowe, 3PL lub raportowe, które śledzą subskrypcje według identyfikatora, muszą przeprowadzić ponowną synchronizację. Zobacz Realizacja i mapowanie 3PL.

Ograniczenia specyficzne dla Stay AI

  • Subskrypcji prepaid (opłacanych z góry) nie można modyfikować. Stay nie pozwala na żadne zmiany w subskrypcji, za którą klient zapłacił z góry, niezależnie od typu ulepszenia. Jeśli klient w planie prepaid zaakceptuje ofertę ulepszenia, ulepszenie zostaje anulowane, a płatność zwrócona, więc subskrypcja pozostaje nietknięta. Z tego samego powodu nie możesz zamienić subskrypcji na produkt sprzedawany wyłącznie w planach z płatnością z góry.
  • Anulowania są ograniczone do jednej aplikacji na konto. Stay wysyła aktualizacje o anulowaniach tylko do jednej aplikacji na konto. Jeśli inna aplikacja lub integracja zarejestrowała się na webhook anulowania Stay przed Aftersell, Aftersell nie może otrzymywać tych aktualizacji, a wykres anulowanych subskrypcji nie będzie odzwierciedlał anulowań w Stay. Podłączany klucz API musi zawierać uprawnienie Webhooks (zobacz poniżej), aby śledzenie anulowań w ogóle działało.
  • Zmiana częstotliwości dotyczy całej subskrypcji. Stay ma jeden harmonogram na subskrypcję, więc zmiana częstotliwości dostaw przesuwa każdy produkt w tej subskrypcji. Gdy subskrypcja zawiera dwa lub więcej produktów, musisz włączyć w ofercie opcję Keep on existing subscription; w przeciwnym razie ulepszenie częstotliwości zostanie odrzucone, a kupującemu zostanie zwrócona płatność. Jest to potrzebne tylko przy zmianach częstotliwości - zamiany produktów i dodatki nie są tym objęte i działają bez tej opcji.
  • Dodanie większej ilości produktu, który klient już subskrybuje, wymaga zgodnej ceny. Gdy dodatek jest produktem, który klient już ma, Stay zwiększa jego ilość zamiast dodawać pozycję - ale tylko wtedy, gdy cena oferty odpowiada temu, co klient już za niego płaci. Jeśli ceny się różnią (na przykład dodatek oferuje 20% zniżki, a plan klienta 10%), ulepszenie zostaje odrzucone, a subskrypcja pozostaje bez zmian. Ustaw dla dodatku taki sam rabat jak w planie klienta lub zaoferuj inny produkt (inny produkt nie jest tym objęty).
  • Waluta musi odpowiadać cenom w Twoim sklepie. Jeśli subskrypcja klienta jest rozliczana w walucie, w której Twój sklep nie ustala cen, ulepszenie zostaje odrzucone.
  • Zduplikowanych subskrypcji z jednego zamówienia nie da się rozróżnić. Jeśli jedno zamówienie zapoczątkowało dwie subskrypcje Stay, które obie zawierają produkt oferty, Aftersell nie jest w stanie ustalić, o którą chodziło klientowi, więc ulepszenie zostaje odrzucone, zamiast zostać zastosowane do niewłaściwego kontraktu.
  • Limity zapytań ograniczają przepustowość. Stay pozwala na 60 zapytań na minutę na konto. Jedno ulepszenie wymaga od czterech do sześciu zapytań, więc sklep osiąga maksymalnie około 10-15 ulepszeń na minutę w szczycie.

Generowanie klucza API Stay AI

  1. W panelu Stay AI przejdź do Account → API tokens → Add API key.
  2. Podczas tworzenia klucza wybierz All permissions. Aftersell potrzebuje dostępu do Subscriptions, Orders, Selling Plan Groups i Webhooks. To uprawnienie Webhooks pozwala Aftersell dowiadywać się o anulowaniach.
  3. Skopiuj klucz i przechowuj go w bezpiecznym miejscu. Traktuj go jak hasło.
Więcej szczegółów znajdziesz w dokumentacji uwierzytelniania API Stay AI.

Łączenie Stay AI w kreatorze konfiguracji

Gdy dotrzesz do Kroku 1: Połącz dostawcę w kreatorze ulepszeń subskrypcji:
  1. Wybierz Stay AI z listy rozwijanej Subscription provider.
  2. Wklej swój klucz API w pole API key.
  3. Kliknij Test API key. Aftersell zweryfikuje klucz, sprawdzając, czy uwierzytelnia się poprawnie 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”. Klucz został uwierzytelniony i należy do Twojego sklepu. Przycisk Continue jest teraz aktywny. Jeśli kluczowi brakuje uprawnienia Webhooks, test nadal kończy się pomyślnie, ale ostrzega, że anulowania subskrypcji nie będą rejestrowane - utwórz klucz ponownie w Stay AI z opcją All permissions, jeśli chcesz śledzić anulowania.
  • Czerwona ikona anulowania. Weryfikacja nie przebiegła pomyślnie. Przeczytaj komunikat obok ikony: albo klucz został odrzucony, 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 klucz - 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 klucza czyści poprzedni wynik.

Weryfikacja ulepszenia w Stay AI

Po złożeniu zamówienia testowego i zaakceptowaniu oferty ulepszenia: Przejdź do Subscriptions w panelu Stay AI i znajdź subskrypcję klienta. Częstotliwość rozliczeń, produkt lub data następnego obciążenia powinny odzwierciedlać zmianę. Sama zmiana jest stosowana, gdy tylko Aftersell przetworzy akceptację, ale Stay może potrzebować czasu na przyjęcie zupełnie nowego zamówienia: ulepszenie zwykle pojawia się w ciągu kilku minut, a w najwolniejszych przypadkach do 24 godzin. Jeśli zmiany jeszcze nie ma, odczekaj chwilę, zanim uznasz to za błąd.

Jeśli ulepszenia nie można zastosować

Ulepszenia w Stay AI są z założenia bezpieczne - kupujący nigdy nie zostaje obciążony za ulepszenie, które nie zostało zrealizowane:
  • Nieudane ulepszenia są ponawiane automatycznie. Jeśli wywołanie Stay AI się nie powiedzie, Aftersell ponawia je w procesie działającym w tle.
  • Jeśli nadal nie można go zastosować, kupującemu zwracana jest płatność. Subscription Upgrade obciąża zamówienie Shopify jedynie za małą pozycję zastępczą (a nie za produkt, który kupujący zachowuje), więc Aftersell zwraca tę opłatę, gdy ulepszenia nie da się ukończyć.
  • Wszystko, czego nie da się potwierdzić, jest oznaczane do ręcznego przeglądu, zamiast być zgadywane, więc kupujący nigdy nie zostaje obciążony za ulepszenie, które nie zostało zrealizowane.
Pełny mechanizm ponawiania i uzgadniania (wspólny dla wszystkich dostawców) znajdziesz w sekcji Jak działają ulepszenia subskrypcji.

Rozwiązywanie problemów specyficznych dla Stay AI

Ulepszenie zostało zaakceptowane, ale subskrypcja nie została zmodyfikowana Najczęstsze przyczyny:
  • Klient ma plan prepaid (opłacany z góry). Stay nie pozwala na modyfikowanie kontraktów prepaid, więc ulepszenie zostaje anulowane, a płatność zwrócona. To oczekiwane zachowanie.
  • Subskrypcja jest rozliczana w walucie, w której Twój sklep nie ustala cen, więc ulepszenie zostało odrzucone.
  • Subskrypcja zawiera dwa lub więcej produktów, a częstotliwość została zmieniona bez włączenia opcji Keep on existing subscription.
  • Jedno zamówienie zapoczątkowało dwie subskrypcje Stay, które obie zawierają produkt oferty, więc Aftersell nie mógł ustalić, którą ulepszyć.
  • Twój klucz API pochodzi z innego sklepu lub brakuje mu wymaganego uprawnienia (Subscriptions, Orders lub Selling Plan Groups). Utwórz lub wybierz ponownie klucz w Stay AI, przejdź do Kroku 1: Połącz dostawcę i przetestuj go ponownie.
  • 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ę. Anulowania w Stay nie są widoczne w analityce Stay wysyła aktualizacje o anulowaniach tylko do jednej aplikacji na konto. Jeśli inna aplikacja zarejestrowała się na webhook anulowania Stay przed Aftersell, Aftersell nie może ich otrzymywać. Upewnij się, że żadna inna integracja nie jest właścicielem webhooka anulowania Stay oraz że podłączony klucz API zawiera uprawnienie Webhooks.
← Wróć do Przeglądu ulepszeń subskrypcji · Konfiguracja · Czym są integracje?