Strona bez WordPressa: skrypt do osadzenia
Prosta strona, która potrafi wyświetlić kwotę i uruchomić jeden skrypt, nie potrzebuje ani wtyczki, ani żadnego programowania. Skrypt odczytuje kwotę, walutę i referencję z Twojej strony i wyświetla kod QR w trybie inline.
data-site |
Adres Twojej strony w takiej postaci, w jakiej dodano go w aplikacji. Jeśli go brak, używany jest adres samej strony. |
|---|---|
data-location |
Identyfikator Twojego Stripe Terminal Location, zaczyna się od tml_. |
data-amount |
Selektor CSS elementu zawierającego kwotę, na przykład #order-total. Waluta może być częścią jego tekstu (CZK, Kč, €). |
data-reference |
Selektor CSS elementu zawierającego numer zamówienia lub inną referencję, od 1 do 64 znaków. |
data-target |
Selektor CSS elementu, w którym pojawia się kod QR. Jeśli go brak, kod QR pojawia się zaraz po skrypcie. |
data-currency, data-description, data-merchant |
Opcjonalne selektory waluty, opisu i nazwy sprzedawcy. Dodaj -value dla stałej wartości (data-currency-value) lub -attr, aby odczytać atrybut zamiast tekstu (data-amount-attr). |
data-ttl |
Jak długo kod QR jest ważny, w sekundach. Domyślnie 300. |
Przygotuj Stripe: zdobądź klucz C (zobacz artykuł o kluczach Stripe) i utwórz ręcznie Terminal Location (Terminal → Locations, skopiuj identyfikator tml_). Nie potrzebujesz webhooka ani kluczy A lub B.
Wgraj qr2stripe.js na swoją stronę i wstaw kod z przykładu za elementami zawierającymi wartości. Hostuj plik samodzielnie, nie ładuj skryptu płatności od osoby trzeciej.
W aplikacji na telefonie postępuj jak w trybie inline: dodaj stronę, włącz opcję Płatność na podstawie danych w kodzie QR (niezweryfikowane przez stronę) i wpisz klucz C.
Przyjęcie płatności: otwórz stronę, zeskanuj kod QR aplikacją, sprawdź kwotę na telefonie i poproś klienta o przyłożenie karty. Gdy kwota na stronie się zmieni, kod QR zmieni się w ciągu sekundy.
Strona nie zmienia się na Paid, bo płatności nie potwierdza żaden serwer. Telefon pokazuje Płatność udana, gdy tylko Stripe potwierdzi płatność kartą, i zapisuje płatność na liście Płatności na tym telefonie. Płatności możesz sprawdzić także w Stripe Dashboard: metadane płatności zawierają source = qr2stripe-inline oraz reservation_id z Twoją referencją.
To tryb inline: kwota nie jest podpisana, więc może ją zmienić każdy, kto edytuje stronę w swojej przeglądarce. Sprawdzaj kwotę na telefonie za każdym razem i używaj skryptu tylko wtedy, gdy jesteś obecny przy płatności. Przy płatnościach bez nadzoru użyj trybu API z wtyczką do WordPressa.
<div id="payment-qr"></div>
<script src="/js/qr2stripe.js"
data-site="https://www.example.com"
data-location="tml_xxxxxxxx"
data-amount="#order-total"
data-reference="#order-number"
data-target="#payment-qr"></script>