web-payments

Umiejętność do implementacji płatności Stripe w aplikacjach webowych. Obsługuje płatności jednorazowe, subskrypcje cykliczne, Checkout hostowany i wbudowany, a także webhooks do obsługi zdarzeń. Zawiera gotowe przykłady dla Node.js i Next.js. Idealna dla deweloperów budujących e-commerce, SaaS lub platformy z systemami rozliczeń. Dokumentacja opiera się na oficjalnych best practices Stripe.

1. Utwórz konto na Stripe (https://dashboard.stripe.com/register), przejdź weryfikację biznesu i pobierz klucze API ze strony kluczy (https://dashboard.stripe.com/apikeys) — będziesz potrzebować klucza tajnego (sk_test_xxx) i publicznego (pk_test_xxx).

2. Skonfiguruj zmienne środowiskowe w pliku .env: STRIPE_SECRET_KEY (tylko serwer), STRIPE_PUBLISHABLE_KEY (klient) i STRIPE_WEBHOOK_SECRET (do weryfikacji webhooków). W produkcji użyj kluczy live (sk_live_xxx, pk_live_xxx).

3. Zainstaluj SDK Stripe dla swojego środowiska: npm install stripe @stripe/stripe-js dla Node.js/Next.js lub pip install stripe dla Pythona.

4. Wybierz metodę integracji: Checkout hostowany (najszybszy start, Stripe obsługuje UI), Checkout wbudowany (dostosowanie do designu) lub Payment Element (pełna kontrola). Dla większości projektów zacznij od Checkout.

5. Utwórz endpoint serwera (np. /api/checkout w Next.js), który inicjuje sesję Stripe za pomocą SDK — przekaż dane produktu, ceny i URL powrotu. Endpoint zwróci URL sesji, którym przekierujesz użytkownika.

6. Skonfiguruj webhooks w dashboardzie Stripe, aby obsługiwać zdarzenia (payment_intent.succeeded, customer.subscription.updated) — webhook endpoint musi weryfikować podpis używając STRIPE_WEBHOOK_SECRET.