Konfigurowanie subskrypcji z tpay

Przygotuj plany cyklicznych zamówień, przypisz je do produktów i skonfiguruj płatności. Klient wybiera subskrypcję podczas zakupów, a kolejne cykle obsługuje harmonogram modułu.

Przed rozpoczęciem: dokumentacja paczki 0.10.7 oznacza ją jako wersję do testów. Konfigurację i pełny cykl płatności sprawdź najpierw w środowisku testowym tpay. Bramkę kartową pozostaw wyłączoną do czasu potwierdzenia jej działania w takim teście.

Subskrypcje z tpay, wersja 0.10.7.

Na tej stronie

Podłączanie konta tpay

  1. Zainstaluj paczkę ZIP w Moduły → Menedżer modułów i otwórz konfigurację AJIT Subskrypcje.
  2. Włącz Sandbox tpay i wpisz dane testowe: tpay Client ID oraz tpay Client Secret.
  3. Włącz bramkę powtarzalnego BLIK.
  4. Ustaw Model BLIK Recurring zgodny z usługą aktywowaną na koncie tpay. Domyślny model M zakłada potwierdzanie obciążeń przez klienta.
  5. Skopiuj URL notyfikacji tpay do konfiguracji powiadomień na koncie tpay.
  6. Zapisz ustawienia i sprawdź diagnostykę modułu.

Skopiuj pełny adres notyfikacji z panelu, razem z parametrami. Samo podanie danych API nie zastępuje konfiguracji odbioru potwierdzeń płatności i rejestracji zgody na płatności cykliczne.

Tworzenie planu

  1. Otwórz panel Planów subskrypcyjnych modułu w części zamówień.
  2. W sekcji Nowy plan wpisz nazwę i ewentualny rabat subskrypcyjny.
  3. Podaj Interwały (dni), np. 14,30, oraz interwał domyślny.
  4. Ustaw przypomnienie przed obciążeniem.
  5. Wybierz dozwolone metody płatności. Każda musi być też włączona w konfiguracji globalnej.
  6. Określ, czy klient może pomijać dostawy, przesuwać termin, zmieniać ilość i częstotliwość.
  7. Włącz aktywność i kliknij Zapisz plan.

Przypisywanie produktów

  1. W Przypisz plan do produktów wybierz zapisany plan.
  2. Wyszukaj produkty lub zaznacz kategorie w drzewie.
  3. Ustaw Pozwól też na zakup jednorazowy, jeśli klient ma mieć taki wybór.
  4. Kliknij Przypisz.
  5. Sprawdź przypisanie na liście produktów subskrypcyjnych oraz wybór trybu zakupu na karcie produktu.

Wyłączenie zakupu jednorazowego oznacza, że produkt wymaga prawidłowej ścieżki subskrypcji. Gdy koszyk nie spełnia jej warunków, klient musi poprawić koszyk lub skontaktować się ze sklepem.

Wykonywanie pierwszego zakupu testowego

  1. Zaloguj się w sklepie jako klient testowy i użyj waluty PLN.
  2. Wybierz produkt z planem, tryb subskrypcji i częstotliwość.
  3. Przejdź przez koszyk, wybierz dostawę i dostępną metodę cykliczną.
  4. Wykonaj płatność w środowisku testowym.
  5. Po powiadomieniu z tpay sprawdź zamówienie, status subskrypcji i potwierdzenie tokenu płatności.

Aktywna subskrypcja powstaje w procesie zakupu klienta. Nie tworzy się jej samym przypisaniem produktu do planu.

Uruchamianie kolejnych cykli

  1. Skopiuj URL CRON i skonfiguruj regularne wywołanie na hostingu.
  2. Ustaw Harmonogram ponowień (dni) dla nieudanych obciążeń, np. 1,3,7.
  3. Sprawdź politykę zmiany ceny i braku produktu. Domyślne zatrzymanie do decyzji klienta wymaga późniejszej odpowiedzi klienta.
  4. W środowisku testowym sprawdź kolejny cykl oraz obsługę nieudanej płatności.
  5. W szczegółach subskrypcji porównaj następny termin, log obciążeń i powiązane zamówienie.

Kolejny cykl buduje nowe zamówienie z dostawą. Kwota produktów prezentowana w wiadomości o zmianie może nie obejmować kosztu dostawy doliczanego w zamówieniu.

Obsługiwanie zatrzymanej subskrypcji

Otwórz szczegóły subskrypcji i sprawdź powód, kwotę, log obciążeń oraz transakcję tpay. Nie traktuj każdego zatrzymania jako zwykłej pauzy.

Przycisk Obciąż przy najbliższym CRON zmienia moment próby pobrania, dlatego używaj go zgodnie z ustalonym terminem obsługi klienta.

Funkcje konta klienta i dodatkowe uprawnienia

W koncie klienta dostępne są działania dozwolone w planie, np. pominięcie lub przesunięcie dostawy. W planie możesz też wskazać produkty dodatkowe do najbliższej dostawy oraz grupy klientów nadawane po aktywacji.

W części dostępu do CMS można ograniczyć wybrane strony do aktywnych subskrybentów lub konkretnych planów. Sprawdź stronę jako klient uprawniony oraz klient bez subskrypcji.

Rozwiązywanie problemów

Brak metody płatności cyklicznej

Sprawdź logowanie klienta, PLN, aktywność planu, przypisanie produktu, dozwoloną bramkę i konfigurację tpay. Przeczytaj komunikat koszyka dotyczący niezgodnych planów lub personalizacji.

Subskrypcja czeka na potwierdzenie

Sprawdź adres notyfikacji i potwierdzenie zgody na płatności cykliczne. Samo zamówienie w PrestaShop nie dowodzi, że operator potwierdził płatność i token.