Przejdź do treści
QR code to Stripe paymentsDokumentacja QR2Stripe

← Wszystkie poradniki

Konfiguracja wtyczki WordPress

Wtyczka QR2Stripe Pay tworzy płatności, wyświetla kod QR i oznacza płatność jako opłaconą, gdy Stripe ją potwierdzi.

Temporary Stripe key Klucz A. Automatyczna konfiguracja Stripe używa go raz i go nie zapisuje.
Location name, Street, City, Postal code, Country (2 letters) Adres Terminal Location. Kraj musi odpowiadać krajowi Twojego konta Stripe.
Terminal Location ID Identyfikator Terminal Location, zaczyna się od tml_. Uzupełnia go automatyczna konfiguracja.
Webhook signing secret Sekret podpisu webhooka Stripe, zaczyna się od whsec_. Bez niego płatności nigdy nie są oznaczane jako opłacone.
QR mode API (zalecany) lub Inline. Zobacz artykuł o trybie API i trybie inline.
Website Stripe key (API mode) Klucz B. Zamiast zapisywać go tutaj, możesz zdefiniować QR2STRIPE_API_KEY w wp-config.php, wtedy klucz nie jest przechowywany w bazie danych.
QR validity (minutes) Jak długo kod QR można opłacić. Domyślnie 10 minut.
Default currency, Merchant name Waluta nowych płatności i nazwa sprzedawcy wyświetlana w telefonie.

Instalacja wtyczki: w WordPressie otwórz Wtyczki → Dodaj nową → Wyślij wtyczkę, wyślij qr2stripe-pay-VERSION.zip i kliknij Włącz. Automatycznie tworzona jest strona Payment z shortcodem [qr2stripe_payment].

Automatyczna konfiguracja Stripe: otwórz QR2Stripe → Settings → Automatic Stripe setup, wklej klucz A, wpisz nazwę i adres Location i kliknij Set up Stripe. Wtyczka tworzy Terminal Location i webhook oraz zapisuje Location ID i sekret podpisu webhooka. Klucz A jest używany raz i nie jest zapisywany. Zaraz potem usuń klucz A w Stripe.

Wybierz tryb QR. W trybie API wklej klucz B w pole Website Stripe key (API mode) lub zdefiniuj go w wp-config.php (zobacz pierwszy przykład). Zapisz ustawienia.

Żółte ostrzeżenia u góry stron QR2Stripe pokazują, czego jeszcze brakuje. Gdy znikną, strona jest gotowa.

Aby wykonać część w Stripe ręcznie, utwórz Location w Stripe (Terminal → Locations, skopiuj identyfikator tml_) oraz webhook (Developers → Webhooks → Add endpoint lub Add destination) dla zdarzeń z Your account, jedynego zdarzenia payment_intent.succeeded i adresu endpointu z drugiego przykładu. Pokaż sekret podpisu i wklej Location ID oraz sekret w ustawieniach wtyczki. Webhook nie wymaga uprawnień. Musi być dostępny przez publiczne HTTPS, localhost nie działa.

Adres strony musi używać HTTPS, a bezpośrednie odnośniki muszą być włączone (Ustawienia → Bezpośrednie odnośniki, dowolna opcja poza „Domyślne”). W przeciwnym razie adres w kodzie QR zawiera ?rest_route= i aplikacja go odrzuca.

define('QR2STRIPE_API_KEY', 'rk_...');
https://YOUR-SITE/wp-json/qr2stripe/v1/stripe-webhook