Files
sorsfonalak/docs/fizetes.md
T
fecoandClaude Opus 5.5 d9e71ed349
CI / test (push) Successful in 1m22s
CI / build (push) Successful in 7m0s
CI / deploy (push) Skipped
Purchases for admins only until the opening; brand images for Stripe
PURCHASES_OPEN (default false) keeps Stripe purchases to admins, also with
a live key, so nobody types a real card before the opening.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_012vLHzh5qUhFtmJhzkcTbXL
2026-11-20 06:57:00 +00:00

3.4 KiB

Fizetés (Stripe)

A csomagokat a Stripe Checkout fizetési oldalán lehet megvenni. A csomagok neve, tartalma és ára a services/backend/src/packages.rs-ben van; minden fizetés ezekkel indul, a Stripe-ban nem kell termékeket felvenni.

Menete

  1. A „Megveszem” gomb a POST /v1/payments/checkout végpontot hívja (package, return_path: az oldal, ahonnan indult).

  2. A backend létrehoz egy Checkout Sessiont (bruttó ár forintban, a csomag neve, a felhasználó e-mail-címe, kötelező számlázási cím), elmenti a stripe_checkouts táblába, és visszaadja a fizetési oldal címét.

  3. Fizetés után a Stripe visszaküld ugyanarra az oldalra ?fizetes=<session id> paraméterrel (megszakításkor ?fizetes=megszakitva). A PaymentReturn komponens a GET /v1/payments/checkout/{id} végpontot kérdezi, amíg a fizetés be nem igazolódik.

  4. A csomagot a backend akkor adja meg, amikor a Stripe igazolja a fizetést:

    • a webhook (POST /api/v1/payments/stripe/webhook, aláírással ellenőrizve), vagy
    • ha a webhook még nem jött meg (vagy helyben nincs beállítva), a visszatérő oldal kérdésére a backend maga kérdezi meg a Stripe-ot.

    A session id miatt egy fizetés csak egyszer ír jóvá (package_orders.source = 'stripe').

Beállítás

A kulcsok a .env.secrets fájlba kerülnek (helyben a repó gyökerében, a szerveren a /opt/sorsfonalak mappában), git-be soha:

STRIPE_SECRET_KEY=sk_test_...
STRIPE_WEBHOOK_SECRET=whsec_...
  • A megnyitásig csak az adminok vásárolhatnak (PURCHASES_OPEN=false, az alapértelmezés), a többieknek a gombok „Hamarosan” feliratúak; így senki nem ad meg valódi kártyát egy teszt- vagy félkész beállításnál.
  • Teszt kulccsal (sk_test_…) PURCHASES_OPEN=true mellett is csak adminok vásárolhatnak (a Stripe tesztkártyáival senki nem jut csomaghoz). Tesztkártya: 4242 4242 4242 4242, bármilyen jövőbeli lejárat és CVC.
  • Élő kulccsal és PURCHASES_OPEN=true mellett mindenki vásárolhat (megnyitáskor, a .env-ben).
  • Kulcs nélkül nincs vásárlás (helyben a MOCK_PAYMENTS=true próbafizetés működik; a Stripe-kulcs ezt felülírja).

A Stripe felületén:

  1. Developers → API keys: a Secret key → STRIPE_SECRET_KEY.
  2. Developers → Webhooks → Add endpoint: https://sorsfonalak.hu/api/v1/payments/stripe/webhook, események: checkout.session.completed és checkout.session.async_payment_succeeded. A Signing secret → STRIPE_WEBHOOK_SECRET. Teszt és élő módban külön végpontot kell felvenni, külön titokkal.
  3. Settings → Branding: logó, színek (a fizetési oldal kinézete).
  4. Settings → Payment methods: bankkártya, Apple Pay, Google Pay.

A kulcsok módosítása után a backendet újra kell indítani (docker compose up -d backend).

Helyben a webhook nem ér el a géphez; nem is kell, mert a visszatérő oldal a Stripe-tól kérdezi le a fizetést. Ha mégis próbálni kell: stripe listen --forward-to localhost:3001/api/v1/payments/stripe/webhook.

Megnyitás előtt

  • A Stripe-fiók aktiválása (céges adatok, bankszámla), élő kulcsok és élő webhook.
  • Számla: Billingo API-val, minden sikeres fizetés után (a vásárló neve és címe a Checkoutból jön). A Stripe nyugtája nem magyar számla.
  • Visszatérítés: egyelőre a Stripe felületén, a csomagot pedig az admin oldalon kell kézzel csökkenteni.