ETAP 01
Szybki koszyk i personalizacja dedykacji
Klient wybiera nominał (100–1000 zł), wpisuje imię obdarowanego i dedykację. Koszyk działa natychmiast w pamięci przeglądarki bez konieczności zakładania konta.
Checkout Zero-FrictionW produkcjiModuł systemu U Kalmana · w produkcji
Sprzedaż voucherów bez obsługi: płatność BLIK, PDF z kodem i realizacja jednym kliknięciem
Zastąpienie ręcznego wypisywania bonów podarunkowych i sprawdzania wyciągów bankowych w pełni zautomatyzowanym silnikiem e-commerce. Płatności Stripe, automatyczne generowanie PDF-ów z kodami QR i natychmiastowa autoryzacja w kasie lokalu.
Wąskie gardło procesu
Ręczne wypisywanie bonów i utracone zamówienia po godzinach
Klienci szukający prezentu na ostatnią chwilę trafiali na barierę: bon można było kupić tylko osobiście w godzinach otwarcia lub po mailowym kontakcie z recepcją i przesłaniu potwierdzenia przelewu.
- brak możliwości zakupu w nocy, w święta i w niedziele niehandlowe,
- pracownicy recepcji musieli ręcznie wypisywać papierowe zaproszenia i pilnować rejestru w Excelu,
- ryzyko fałszowania numerów lub podwójnego wykorzystania tego samego bonu,
- konieczność ręcznego księgowania każdej wpłaty z rachunku bankowego.
Architektura rozwiązania
Cyfrowy obieg: Stripe Checkout, wektorowy PDF i skaner QR
Zaprojektowałem i wdrożyłem niezależny silnik sprzedaży wpięty w ekosystem Next.js i Supabase. Proces od wejścia klienta na stronę do wygenerowania gotowego do druku bonu trwa kilkadziesiąt sekund.
- 3-krokowy checkout bez wymogu rejestracji: wybór kwoty, dedykacja, płatność BLIK/kartą,
- mikroserwis PDFKit generujący elegancki certyfikat z unikalnym kodem kreskowym i QR,
- powiadomienie SMS i e-mail wysyłane w tle, z załącznikiem do natychmiastowego pobrania,
- aplikacja PWA dla personelu z wbudowanym skanerem QR do natychmiastowej realizacji bonu przy kasie.
Architektura transakcyjna
Jak działa przepływ zamówienia w tle
Od autoryzacji w Stripe po natychmiastową blokadę w kasie POS — bezpieczny przepływ odporny na przerwy w łączności.
Architektura inżynierska
Przebieg realizacji transakcji i generowania bonu
Jak dane przepływają przez system: od wejścia zdarzenia, przez buforowanie i reguły biznesowe, po trwały zapis i powiadomienia.
ETAP 02
Bramka płatności Stripe i natychmiastowy BLIK
Sesja płatności Stripe Checkout z bezpośrednią obsługą BLIK, kart płatniczych i Apple Pay / Google Pay. Zabezpieczenie przed podwójnym kliknięciem i porzuceniem sesji.
Stripe API · potwierdzenia płatnościETAP 03
Wektorowy generator certyfikatu PDF z kodem QR
Po autoryzacji płatności mikroserwis w tle generuje w locie wektorowy dokument PDF z unikalnym kodem kreskowym, hashem bezpieczeństwa i dedykacją.
Dynamic PDFKit & QR EngineETAP 04
Wielokanałowa dystrybucja i autoryzacja w kasie
Klient otrzymuje maila z załącznikiem PDF oraz SMS z kodem. W lokalu personel skanuje kod QR w panelu kasowym w ułamku sekundy, rejestrując realizację w bazie.
Real-Time POS ValidatorSTUDIUM PRZYPADKU: VOUCHER (SPRZEDAŻ & REALIZACJA)
Jak projektuję procesy: interaktywna architektura
Poniższy diagram ilustruje, jak szczegółowo mapuję przepływy danych i wdrażam zabezpieczenia biznesowe (tzw. uszczelnienia), zanim napiszę pierwszą linię kodu.
Zakup i Stripe — Bezpieczny koszyk i płatność
Klient wybiera kwotę. Serwer tworzy transakcję i generuje zabezpieczoną sesję Stripe.
Przepływ węzłów w systemie
KROK 1KlientWybór w kreatorze
KROK 2Next.js APIWalidacja serwera
KROK 3Stripe APIPłatność 3D-Secure
KROK 4Baza danychZapis PENDING
Zabezpieczenia & Uszczelnienia logiczne
Płatność liczona raz
Uniemożliwia dwukrotne obciążenie karty przy wielokrotnym kliknięciu.
Walidacja serwera
Cena jest weryfikowana na backendzie, nie w przeglądarce.
Podpis powiadomienia
Podpis Stripe chroni przed sfałszowanymi potwierdzeniami płatności.
Niezawodność i Kontrola
Standard wykonania dedykowanego e-commerce
Rozwiązanie szyte na miarę, bez ciężaru uniwersalnych wtyczek CMS i podatności na błędy.
Sprzedaż poza godzinami pracy firmy
Klienci kupują bony podarunkowe o 23:00 lub w niedzielę rano. Wcześniej wymagało to wizyty w lokalu lub kontaktu z obsługą — teraz sprzedaż działa samoobsługowo.
Płatności BLIK, karty i portfele mobilne
Zintegrowana bramka Stripe Checkout zoptymalizowana pod polski rynek. Bezpieczna obsługa transakcji, natychmiastowe księgowanie i zero konieczności ręcznego sprawdzania wyciągów.
Generowanie wektorowego PDF z unikalnym QR
Każdy voucher otrzymuje unikalny token kryptograficzny zakodowany w kodzie QR. Estetyczny, gotowy do wydruku plik PDF trafia na skrzynkę klienta automatycznie po wpłacie.
Blokada podwójnego wykorzystania w POS
Dedykowany widok weryfikacji dla personelu: skanowanie aparatem telefonu lub wpisanie 6-znakowego kodu. Baza od razu blokuje powtórne użycie zrealizowanego bonu.
Wdrożenie produkcyjne
System pracuje na żywo w produkcji
Platforma realizuje transakcje 24/7. Moduł generowania kodów QR i obsługi płatności BLIK można przetestować bezpośrednio w działającym wdrożeniu.