Ekspresowy Checkout: konfiguracja i pomoc

Prześlij ZIP wydania przez Moduły > "Module Manager" > "Upload a module", a następnie zainstaluj Stripe Express Checkout. Otwórz Express Checkout > Ustawienia > Konfiguracja. Moduł dodaje też Panel, Zamówienia, Klienci, Konfiguracja i pomocnicze strony ustawień. Moduł zawiera bibliotekę Stripe PHP (stripe/stripe-php ^15.0).

Wymaga PrestaShop 1.6 lub nowszego i PHP 7.1 lub nowszego.

Potrzebujesz konta Stripe, prawidłowych kluczy dla wybranego trybu, działających połączeń wychodzących HTTPS i publicznie dostępnego endpointu webhooka. Dostępność portfeli zależy też od uprawnień konta Stripe, waluty, urządzenia, przeglądarki i portfela klienta.

Otwórz kartę Ogólne.

Kupujący zalogowany na inne konto nadal jest odrzucany przez regułę dotyczącą istniejących kont. Moduł zapisuje wymaganą akceptację pól wyboru wraz z transakcją.

Otwórz Stripe Keys.

Pozostaw Przetwarzanie płatności rzeczywistych wyłączone i najpierw zapisz parę testową. Moduł wymaga obu aktywnych kluczy z oczekiwanymi prefiksami i bez białych znaków na początku lub końcu, więc nie da się pomieszać kluczy testowych i produkcyjnych. Nie potrafi jednak stwierdzić, czy klucz publiczny i sekretny należą do tego samego konta Stripe, więc wykonaj płatność testową.

Zapis konfiguracji sprawdza też infrastrukturę webhooków modułu i odświeża dostępność metod płatności. Usuń przyczyny ostrzeżeń Webhooki nie są zainstalowane. Moduł nie będzie działał poprawnie oraz o wymaganych kluczach, zanim przejdziesz dalej. URL sklepu i endpoint webhooka muszą pozostać dostępne dla Stripe.

Tryb Live modułu i Przetwarzanie płatności rzeczywistych są niezależne. Możesz ograniczyć widoczność podczas testowania rzeczywistego przetwarzania lub omyłkowo udostępnić przetwarzanie testowe. Sprawdź oba przełączniki przed udostępnieniem płatności klientom.

Otwórz Express Checkout > Konfiguracja > Opcje płatności. Moduł obsługuje karty przetwarzane przez Stripe, Apple Pay, Google Pay, Link i PayPal, zależnie od dostępności. Zawiera też ręczne opcje płatności. Nowo zainstalowane wiersze początkowo nie mają potwierdzonej dostępności Stripe; konfiguracja odświeża ich status Stripe.

Otwórz konfigurację każdej opcji i sprawdź Aktywny, przetłumaczone teksty przycisków i okien modalnych oraz ustawienia właściwe dla danej metody. Sprawdź powiązania opcji ze sklepami, językami, grupami klientów, przeglądarkami, typami stron, walutami i krajami. Wyświetlaj wszędzie i każdy przełącznik "All ..." określają, czy odpowiedni szczegółowy wybór ma zastosowanie. Nie zakładaj, że aktywna opcja jest dostępna w każdym kontekście klienta.

Dla kart Włącz zapisywanie kart jest początkowo włączone. Włącza zapisane metody płatności i link Zarządzaj zapisanymi kartami na koncie klienta. Sprawdź URL strony zapisanych kart, Metatytuł strony kart i Metaopis strony kart. Wyłącz autouzupełnianie Link jest początkowo wyłączone.

Dla portfeli Użyj adresu rozliczeniowego z portfela jest początkowo włączone. "Wallet unavailable behaviour" początkowo ukrywa przycisk niedostępnego portfela. Alternatywy to Pokaż przycisk i Pokaż nieaktywny przycisk. Wyświetlenie przycisku nie zapewnia dostępności nieobsługiwanego portfela.

Teksty metod obejmują Etykietę, "Express Button Text", Nagłówek okna modalnego, Tekst przycisku okna modalnego, Tekst przycisku płatności, Tekst opcji płatności i Tekst przetwarzania. Początkowo pozostaw dostarczone tłumaczenia, a następnie zmieniaj je tam, gdzie proces płatności wymaga innych instrukcji. Ręczny przelew bankowy ma własne dane bankowe i ustawienia emaila potwierdzającego.

Otwórz Express Checkout > Konfiguracja > Usługi wysyłkowe. Instalacja importuje usługi dla istniejących przewoźników. Sprawdź przewoźników nadal oznaczonych jako nieskonfigurowani.

W usłudze ustaw Przewoźnik sklepu, Nazwa usługi, Opis, Minimalny czas tranzytu (dni), Maksymalny czas tranzytu (dni), Tryb wyświetlania i Express Checkout. Usługa stanowi warstwę prezentacji i kwalifikacji przewoźnika sklepu. Sama nie tworzy umowy z przewoźnikiem ani nie pobiera jego aktualnych stawek.

Otwórz powiązania usługi. Wszystkie opcje płatności i Określone opcje płatności sterują ścieżkami płatności modułu dla tej usługi. Wszystkie zewnętrzne moduły płatności i Zewnętrzne moduły płatności sterują ścieżkami zewnętrznymi. Zapisz powiązania, a następnie przetestuj usługę z każdą planowaną metodą płatności.

Globalne opcje ekranu obejmują:

• Domyślna opcja wysyłki: początkowo odpowiada usłudze domyślnego przewoźnika sklepu. Wybierz kwalifikującą się opcję zapasową.
• Etykieta wirtualnego przewoźnika: dostarczona angielska wartość domyślna "Digital Delivery", z przetłumaczonymi wartościami domyślnymi.
• Szczegóły wirtualnego przewoźnika: dostarczona angielska wartość domyślna "Instant access after payment", z tłumaczeniami. Sprawdź ją, jeśli dostawa cyfrowa nie jest natychmiastowa.

Kwalifikacja przewoźnika, zawartość koszyka i powiązania wpływają na oferowane ścieżki. Wybrana usługa, koszt i sposób prezentacji dostawy są zachowywane w danych procesu płatności. Sprawdź ostateczny koszt dostawy w utworzonym zamówieniu.

Logowanie społecznościowe

Przełączniki dostawców są początkowo wyłączone, a dane dostępowe puste. Włącz tylko dostawców, których skonfigurujesz i przetestujesz.

• Włącz logowanie przez Google używa ID klienta OAuth Google. Włącz Google One Tap to oddzielny opcjonalny monit, początkowo wyłączony.
• Włącz logowanie przez Apple używa Apple Service ID, Apple Team ID, Apple Key ID i Apple Private Key. Klucz prywatny to zawartość .p8 wraz z liniami początkową i końcową.
• Włącz logowanie przez Facebook używa ID klienta OAuth Facebook i Facebook OAuth Secret.
• Włącz logowanie przez Microsoft używa ID klienta OAuth Microsoft.

Te ustawienia sterują logowaniem. Apple Sign-In jest niezależne od Apple Pay, a Google Sign-In od Google Pay.

Autouzupełnianie adresu

Włącz autouzupełnianie Google Places jest początkowo wyłączone. Dodaj Klucz API Google Places, zanim je włączysz. Przetestuj sugestie i ostatecznie zapisany adres w krajach obsługiwanych przez sklep. Konfiguracja i dostępność konta API wpływają na sugestie.

Statusy zamówień

Sprawdź mapowania przed przetwarzaniem zamówień:

Wybierz statusy zgodne z dotychczasowym procesem obsługi zamówień. Mapowanie statusów nie ustala, czy pieniądze wpłynęły; sprawdź transakcję i wynik Stripe.

Odzyskiwanie koszyków i transakcji

Aby zaplanować odzyskiwanie, wybierz metodę cron i skopiuj wygenerowane instrukcje z tej karty. Zawierają endpoint odzyskiwania sklepu, akcję i token oraz przykład uruchamiania co dziesięć minut. Używaj wygenerowanych wartości zamiast kopiować token innego sklepu. Odzyskiwanie uzupełnia przepływ webhooków.

Selektory motywu

Zachowaj te wartości domyślne, chyba że motyw używa innych znaczników:

Zmieniaj selektor dopiero po sprawdzeniu rzeczywistego elementu motywu i przetestowaniu procesu płatności.

Wygląd

Włącz niestandardowe zasoby jest początkowo wyłączone. Po włączeniu ładuje pliki custom.js i custom.css modułu. Szablon sklepu początkowo ma wartość Brak; Warehouse to dostępne ustawienie wstępne.

Ujednolicone okno modalne płatności jest początkowo wyłączone. Włącz je, aby jeden przycisk otwierał listę opcji płatności. Wygląd przycisku początkowo ma wartość Logotypy płatności, a alternatywą jest Tekst i ikony.

"Show company field" i "Show VAT number field" są początkowo włączone. Obowiązują tylko tam, gdzie format adresu kraju zawiera dane pole.

Dostarczone teksty angielskie to "Express Checkout" dla Ujednolicony przycisk Express Checkout, "Complete your purchase" dla Nagłówek okna modalnego, "Pay now" dla Tekst przycisku płatności i "Processing your payment..." dla Komunikat przetwarzania. Sprawdź wszystkie języki sklepu.

Główny kolor tła, Główny kolor czcionki, Drugorzędny kolor tła i Drugorzędny kolor czcionki używają wykrytych wartości motywu. Wartości zapasowe to odpowiednio #1d93ab, #ffffff, #f6f6f6 i #232323.

Hooki

Wybierz lokalizacje w Hooki. Początkowa konfiguracja włącza paymentOptions, displayProductActions i displayExpressCheckout. Lokalizacje koszyka, alternatywne lokalizacje produktu, listy i lokalizacje niestandardowe są początkowo wyłączone, chyba że skonfigurowano je osobno.

Włącz tylko lokalizacje renderowane przez motyw. Dla każdej konfigurowalnej lokalizacji Użyj domyślnego wyglądu jest początkowo włączone. Wyłącz je, aby używać odpowiadających jej lokalnych ustawień wyglądu. Listy produktów/kategorii nadal wymagają, aby motyw wykonywał wybrany hook listy.

Aby umieścić przycisk ręcznie, włącz niestandardową lokalizację i użyj dostarczonych instrukcji hooka. Moduł implementuje displayMPRExpressCheckout; przekaż kontekst produktu przy umieszczaniu przycisku dotyczącego konkretnego produktu.

Moduł może dodawać własne opcje w natywnym procesie składania zamówienia obok istniejących modułów płatności. Nie usuwa wszystkich pozostałych metod, chociaż powiązania wysyłki mogą odfiltrowywać niezgodne opcje.

1. Pozostaw ograniczoną widoczność publiczną i wyłączone Przetwarzanie płatności rzeczywistych.
2. Zapisz prawidłowe klucze testowe i usuń przyczyny ostrzeżeń dotyczących kluczy, webhooków i integralności.
3. Przetestuj zakup ze strony produktu i z koszyka przez każdą włączoną lokalizację.
4. Sprawdź wybrany wariant, ilość, adres, pola akceptacji, usługę wysyłkową, rabat i końcową kwotę.
5. Zakończ płatność testową i potwierdź utworzenie jednego zamówienia z prawidłową płatnością i statusem.
6. Porównaj Zamówienia > Transakcje i Zamówienia > Obciążenia ze Stripe. Przetestuj przerwany powrót i wybraną ścieżkę odzyskiwania.
7. Jeśli funkcja jest włączona, zapisz kartę i sprawdź Zarządzaj zapisanymi kartami na koncie klienta. Przetestuj zwrot przez Zamówienia > Zwroty i sprawdź jego potwierdzony wynik.
8. Wpisz parę produkcyjną i włącz Przetwarzanie płatności rzeczywistych dopiero po testach. Włącz Tryb Live modułu, gdy publiczny proces płatności będzie gotowy.

Zamówienia zawiera też Koszyki. Klienci zawiera Metody płatności, Klienci z mediów społecznościowych i Sesje odwiedzających. Panele zamówień i klientów pokazują powiązane informacje procesu płatności. Sesje odwiedzających zachowują pola źródła i kampanii, urządzenie, przeglądarkę, dostępność portfeli i kontekst pierwszej wizyty, jeśli dane te zostały zebrane. Używaj tych rekordów do analizy porzuconej lub przerwanej sesji; nie dowodzą one przyczyny porzucenia.

• Brak przycisków: sprawdź Status modułu, Tryb Live modułu, dozwolony adres IP/sesję administratora, aktywne opcje płatności, gotowość Stripe, powiązania i odpowiedni hook motywu.
• Brak portfela: sprawdź jego dostępność w Stripe, walutę oraz urządzenie/przeglądarkę klienta, a następnie zachowanie przy niedostępnym portfelu. Nie każdy klient może korzystać z każdego portfela.
• Płatności nie działają po zmianie trybu: sprawdź oba klucze w Stripe Keys, Przetwarzanie płatności rzeczywistych i konfigurację webhooków dla wybranego trybu.
• Brak zgodnej ścieżki wysyłki/płatności: sprawdź natywną kwalifikację przewoźników koszyka i powiązania płatności usługi.
• Płatność się powiodła, ale potwierdzenie przerwano: porównaj Stripe Payment Intent z listą transakcji i statusem odzyskiwania przed kolejną próbą płatności.
• Brak linku zapisanych kart: sprawdź Włącz zapisywanie kart i użyj sesji zalogowanego klienta.

Utwórz kopię zapasową danych operacyjnych modułu przed odinstalowaniem przez "Module Manager". Odinstalowanie usuwa menu, rejestracje webhooków, infrastrukturę statusów zamówień modułu i jego tabele, w tym transakcje, obciążenia, zwroty, odwołania do zapisanych metod płatności, koszyki, konfigurację i sesje. Niepowodzenie zdalnego czyszczenia może zatrzymać odinstalowanie, aby można było poprawić problem i spróbować ponownie.

Odinstalowanie nie zwraca płatności Stripe ani nie cofa już utworzonych zamówień sklepu.