diff --git a/app/Domain/Commerce/Checkout.php b/app/Domain/Commerce/Checkout.php index 128d584..902d131 100644 --- a/app/Domain/Commerce/Checkout.php +++ b/app/Domain/Commerce/Checkout.php @@ -140,6 +140,27 @@ private function createOrder(User $user, Party $holder, array $pairs): Order public function confirmTestPayment(Order $order, string $reference): Order { $this->assertTestDriver(); + + return $this->settle($order, 'test', $reference); + } + + /** + * Zahlung eines Anbieters (Stripe): wie die Testzahlung, aber erst nach Prüfung von Betrag und Währung gegen die + * Bestellung. Wiederholte Meldungen sind wirkungslos. + */ + public function confirmProviderPayment(Order $order, string $provider, string $reference, int $amountCents, string $currency): Order + { + $expected = (int) ($order->total_cents ?? $order->lines()->sum('price_cents')); + + if ($amountCents !== $expected || strtoupper($currency) !== strtoupper((string) ($order->currency ?? 'EUR'))) { + throw new DomainRuleException('Der gezahlte Betrag weicht von der Bestellung ab.'); + } + + return $this->settle($order, $provider, $reference); + } + + private function settle(Order $order, string $provider, string $reference): Order + { $reference = trim($reference); if ($reference === '') { @@ -147,7 +168,7 @@ public function confirmTestPayment(Order $order, string $reference): Order } $paidNow = false; - $order = DB::transaction(function () use ($order, $reference, &$paidNow): Order { + $order = DB::transaction(function () use ($order, $provider, $reference, &$paidNow): Order { $order = Order::query()->lockForUpdate()->findOrFail($order->id); if ($order->status === 'bezahlt') { @@ -158,11 +179,11 @@ public function confirmTestPayment(Order $order, string $reference): Order throw new DomainRuleException('Diese Bestellung nimmt keine Zahlung mehr an.'); } - $order->payments()->create([ - 'provider' => 'test', - 'status' => 'bestaetigt', - 'provider_reference' => $reference, - ]); + // Eine bei Stripe angelegte offene Zahlung mit derselben Referenz wird bestätigt statt doppelt geführt. + $order->payments()->updateOrCreate( + ['provider_reference' => $reference], + ['provider' => $provider, 'status' => 'bestaetigt'], + ); $order->status = 'bezahlt'; $order->save(); $paidNow = true; diff --git a/app/Domain/Commerce/Shop.php b/app/Domain/Commerce/Shop.php index 2803873..93c7070 100644 --- a/app/Domain/Commerce/Shop.php +++ b/app/Domain/Commerce/Shop.php @@ -9,8 +9,19 @@ */ final class Shop { + public static function driver(): string + { + return (string) config('services.payment.driver'); + } + public static function enabled(): bool { - return ! app()->isProduction() && config('services.payment.driver') === 'test'; + return ! app()->isProduction() && in_array(self::driver(), ['test', 'stripe'], true); + } + + /** Stripe-Kasse (Etappe 1: nur Testmodus, nie in Produktion). */ + public static function stripe(): bool + { + return ! app()->isProduction() && self::driver() === 'stripe'; } } diff --git a/app/Domain/Commerce/Stripe/StripeGateway.php b/app/Domain/Commerce/Stripe/StripeGateway.php new file mode 100644 index 0000000..83ecc9d --- /dev/null +++ b/app/Domain/Commerce/Stripe/StripeGateway.php @@ -0,0 +1,145 @@ +assertSandbox(); + $order->loadMissing('lines', 'user'); + + if ($order->status !== 'offen') { + throw new DomainRuleException('Diese Bestellung nimmt keine Zahlung mehr an.'); + } + + $open = $this->reusableSession($order); + + if ($open !== null) { + return $open; + } + + $attempt = $order->payments()->where('provider', 'stripe')->count() + 1; + $params = [ + 'mode' => 'payment', + 'client_reference_id' => (string) $order->id, + 'customer_email' => $order->user->email, + 'locale' => 'de', + 'success_url' => route('member.order', $order).'?zahlung=zurueck', + 'cancel_url' => route('member.order', $order).'?zahlung=abbruch', + 'metadata' => ['order_id' => (string) $order->id], + 'payment_intent_data' => ['metadata' => ['order_id' => (string) $order->id]], + ]; + + foreach ($order->lines->values() as $index => $line) { + $params['line_items'][$index] = [ + 'quantity' => 1, + 'price_data' => [ + 'currency' => strtolower((string) ($line->currency ?? $order->currency ?? 'EUR')), + 'unit_amount' => (int) $line->price_cents, + 'product_data' => ['name' => filled($line->offer_name) ? (string) $line->offer_name : 'Lizenz'], + ], + ]; + } + + $response = $this->request() + ->withHeaders(['Idempotency-Key' => 'luf-order-'.$order->id.'-'.$attempt]) + ->post('/v1/checkout/sessions', $params); + + $this->assertOk($response, 'angelegt'); + $id = (string) $response->json('id'); + $url = (string) $response->json('url'); + + if ($id === '' || $url === '') { + throw new DomainRuleException('Stripe hat keine Kasse geliefert. Bitte versuche es später noch einmal.'); + } + + $order->payments()->create(['provider' => 'stripe', 'status' => 'offen', 'provider_reference' => $id]); + + return ['id' => $id, 'url' => $url]; + } + + public function assertSandbox(): void + { + $secret = (string) config('services.stripe.secret'); + + if (app()->isProduction()) { + throw new DomainRuleException('Stripe ist in Produktion nicht freigegeben.'); + } + + if ($secret === '') { + throw new DomainRuleException('Stripe ist nicht eingerichtet: Der Schlüssel fehlt.'); + } + + if (! str_starts_with($secret, 'sk_test_') && ! str_starts_with($secret, 'rk_test_')) { + throw new DomainRuleException('Etappe 1 erlaubt nur den Stripe-Testmodus (Schlüssel sk_test_).'); + } + } + + /** + * @return array{id: string, url: string}|null + */ + private function reusableSession(Order $order): ?array + { + $payment = $order->payments()->where('provider', 'stripe')->where('status', 'offen')->latest('id')->first(); + + if ($payment === null) { + return null; + } + + try { + $response = $this->request()->get('/v1/checkout/sessions/'.$payment->provider_reference); + } catch (ConnectionException) { + return null; + } + + if ($response->successful() && $response->json('status') === 'open' && filled($response->json('url'))) { + return ['id' => (string) $payment->provider_reference, 'url' => (string) $response->json('url')]; + } + + return null; + } + + private function request(): PendingRequest + { + return Http::baseUrl(rtrim((string) config('services.stripe.api_base'), '/')) + ->withToken((string) config('services.stripe.secret')) + ->asForm() + ->acceptJson() + ->timeout(15); + } + + private function assertOk(Response $response, string $what): void + { + if ($response->successful()) { + return; + } + + // Nur Statuscode und Fehlertyp ins Log, nie Schlüssel oder Kundendaten. + Log::warning('Stripe-Anfrage fehlgeschlagen', [ + 'status' => $response->status(), + 'type' => $response->json('error.type'), + 'code' => $response->json('error.code'), + ]); + + throw new DomainRuleException('Die Zahlung konnte bei Stripe nicht '.$what.' werden. Bitte versuche es später noch einmal.'); + } +} diff --git a/app/Domain/Commerce/Stripe/StripeSignature.php b/app/Domain/Commerce/Stripe/StripeSignature.php new file mode 100644 index 0000000..b65961b --- /dev/null +++ b/app/Domain/Commerce/Stripe/StripeSignature.php @@ -0,0 +1,59 @@ +getTimestamp()) - $timestamp) > self::TOLERANCE_SECONDS) { + throw new DomainRuleException('Die Meldung ist zu alt.'); + } + } +} diff --git a/app/Http/Controllers/Member/CheckoutController.php b/app/Http/Controllers/Member/CheckoutController.php index f2179b2..9eae73c 100644 --- a/app/Http/Controllers/Member/CheckoutController.php +++ b/app/Http/Controllers/Member/CheckoutController.php @@ -9,7 +9,9 @@ use App\Domain\Commerce\Checkout; use App\Domain\Commerce\Order; use App\Domain\Commerce\OrderHolders; +use App\Domain\Commerce\Shop; use App\Domain\Commerce\StaleOverview; +use App\Domain\Commerce\Stripe\StripeGateway; use App\Domain\Entitlement\GrantIssuer; use App\Http\Controllers\Controller; use Illuminate\Http\RedirectResponse; @@ -99,9 +101,26 @@ public function show(Request $request, Order $order): View return view('member.order', [ 'order' => $order, 'testPayment' => ! app()->isProduction() && config('services.payment.driver') === 'test', + 'stripePayment' => Shop::stripe(), + 'zahlung' => $request->query('zahlung'), ]); } + /** Leitet zur Stripe-Kasse (Testmodus). Freigeschaltet wird erst durch die signierte Meldung von Stripe. */ + public function pay(Request $request, Order $order, StripeGateway $stripe): RedirectResponse + { + abort_unless($order->user_id === $request->user()->id, 403); + abort_unless(Shop::stripe(), 404); + + try { + $session = $stripe->checkoutFor($order); + } catch (DomainRuleException $exception) { + return back()->withErrors(['payment' => $exception->getMessage()]); + } + + return redirect()->away($session['url']); + } + public function confirm(Request $request, Order $order, Checkout $checkout): RedirectResponse { abort_unless($order->user_id === $request->user()->id, 403); diff --git a/app/Http/Controllers/StripeWebhookController.php b/app/Http/Controllers/StripeWebhookController.php new file mode 100644 index 0000000..b18fd0b --- /dev/null +++ b/app/Http/Controllers/StripeWebhookController.php @@ -0,0 +1,114 @@ +getContent(); + + try { + $signature->verify($payload, $request->header('Stripe-Signature')); + } catch (DomainRuleException $exception) { + Log::warning('Stripe-Meldung abgewiesen', ['grund' => $exception->getMessage()]); + + return response()->json(['error' => 'Ungültige Signatur.'], 400); + } + + $event = json_decode($payload, true); + + if (! is_array($event) || ! isset($event['type'])) { + return response()->json(['error' => 'Ungültige Nutzlast.'], 400); + } + + $session = (array) ($event['data']['object'] ?? []); + + return match ($event['type']) { + 'checkout.session.completed', 'checkout.session.async_payment_succeeded' => $this->paid($session, $checkout), + 'checkout.session.expired', 'checkout.session.async_payment_failed' => $this->notPaid($session, (string) $event['type']), + default => response()->json(['received' => true, 'handled' => false]), + }; + } + + /** + * @param array $session + */ + private function paid(array $session, Checkout $checkout): JsonResponse + { + if (($session['payment_status'] ?? null) !== 'paid') { + return response()->json(['received' => true, 'handled' => false]); + } + + $order = $this->orderOf($session); + $reference = (string) ($session['id'] ?? ''); + + if ($order === null || $reference === '') { + Log::warning('Stripe-Zahlung ohne zugehörige Bestellung', ['session' => $reference]); + + return response()->json(['received' => true, 'handled' => false]); + } + + try { + $checkout->confirmProviderPayment( + $order, + 'stripe', + $reference, + (int) ($session['amount_total'] ?? -1), + (string) ($session['currency'] ?? ''), + ); + } catch (DomainRuleException $exception) { + // Dauerhafter Fehler (Betragsabweichung, Bestellung nicht mehr offen): nichts freischalten, Zahlung zur + // Prüfung festhalten und 200 antworten, damit Stripe nicht endlos wiederholt. + Log::warning('Stripe-Zahlung nicht übernommen', ['order' => $order->id, 'session' => $reference, 'grund' => $exception->getMessage()]); + $order->payments()->updateOrCreate(['provider_reference' => $reference], ['provider' => 'stripe', 'status' => 'zu_pruefen']); + + return response()->json(['received' => true, 'handled' => false]); + } + + return response()->json(['received' => true, 'handled' => true]); + } + + /** + * @param array $session + */ + private function notPaid(array $session, string $type): JsonResponse + { + $payment = Payment::query()->where('provider', 'stripe')->where('provider_reference', (string) ($session['id'] ?? ''))->first(); + + // Die Bestellung bleibt offen und lässt sich erneut bezahlen; nur diese Kasse gilt nicht mehr. + if ($payment !== null && $payment->status === 'offen') { + $payment->status = $type === 'checkout.session.expired' ? 'abgelaufen' : 'fehlgeschlagen'; + $payment->save(); + } + + return response()->json(['received' => true, 'handled' => $payment !== null]); + } + + /** + * @param array $session + */ + private function orderOf(array $session): ?Order + { + $id = $session['client_reference_id'] ?? ($session['metadata']['order_id'] ?? null); + + return is_numeric($id) ? Order::query()->find((int) $id) : null; + } +} diff --git a/bootstrap/app.php b/bootstrap/app.php index 82e1084..c3bad40 100644 --- a/bootstrap/app.php +++ b/bootstrap/app.php @@ -17,6 +17,8 @@ ) ->withMiddleware(function (Middleware $middleware): void { $middleware->trustProxies(at: '*'); + // Stripe sendet ohne Sitzung und CSRF-Token; die Signatur der Meldung ersetzt beides. + $middleware->validateCsrfTokens(except: ['stripe/webhook']); $middleware->prepend(UseStaffSessionCookie::class); $middleware->prepend(UseRequestRootUrl::class); $middleware->prepend(IgnoreEmptyForwardedHeaders::class); diff --git a/config/services.php b/config/services.php index 1346f70..785ee77 100644 --- a/config/services.php +++ b/config/services.php @@ -29,9 +29,16 @@ ], 'payment' => [ + // test: Testweg ohne Anbieter. stripe: Stripe-Kasse, in Etappe 1 nur mit Testschlüsseln (sk_test_). 'driver' => env('PAYMENT_DRIVER', 'test'), ], + 'stripe' => [ + 'secret' => env('STRIPE_SECRET'), + 'webhook_secret' => env('STRIPE_WEBHOOK_SECRET'), + 'api_base' => env('STRIPE_API_BASE', 'https://api.stripe.com'), + ], + 'slack' => [ 'notifications' => [ 'bot_user_oauth_token' => env('SLACK_BOT_USER_OAUTH_TOKEN'), diff --git a/deploy/luf.env.example b/deploy/luf.env.example index 7ed4df9..fd9abc4 100644 --- a/deploy/luf.env.example +++ b/deploy/luf.env.example @@ -27,7 +27,10 @@ MAIL_MAILER=log MAIL_FROM_ADDRESS="noreply@example.invalid" MAIL_FROM_NAME="${APP_NAME}" -# test bleibt der lokale Testweg. Ein echter Zahlungsdienst ist noch nicht festgelegt. +# test: lokaler Testweg ohne Anbieter. stripe: Stripe-Kasse, in Etappe 1 nur mit Testschlüsseln und nie in Produktion. +# Die Schlüssel stehen nur in /etc/luf/.env auf dem Server, nie im Repo. PAYMENT_DRIVER=test +# STRIPE_SECRET=sk_test_... (Entwickler > API-Schlüssel, Testmodus) +# STRIPE_WEBHOOK_SECRET=whsec_... (Entwickler > Webhooks > Endpunkt > Signiergeheimnis) # Medienpfade setzt Compose auf den Host-Mount (/srv/luf//media/...). Hier nichts eintragen. diff --git a/docs/betrieb/DEPLOYMENT.md b/docs/betrieb/DEPLOYMENT.md index d1e2e4b..7038e5b 100644 --- a/docs/betrieb/DEPLOYMENT.md +++ b/docs/betrieb/DEPLOYMENT.md @@ -27,6 +27,30 @@ ## Env-Datei ändern (zum Beispiel Mail, `APP_URL`) **nginx findet die neue App selbst (seit 21.11.2026).** Der Web-Container löst den Namen `app` über Dockers DNS zur Laufzeit auf (`resolver 127.0.0.11` in `docker/nginx/default.conf`). Vorher war die Adresse beim Start von nginx festgeschrieben: Ein erneuter Lauf mit unverändertem Code erzeugte die App neu, nicht aber den Web-Container, und Prod antwortete mit 502, bis `luf-prod-web-1` neu gestartet wurde (20.11.2026). Ein Test (`tests/Unit/NginxConfigTest.php`) hält die Konfiguration fest. +## Stripe-Sandbox (nur Test, Etappe 1) + +Die Stripe-Kasse läuft ausschließlich im Testmodus und nie in Produktion. Sie ist nur aktiv, wenn `PAYMENT_DRIVER=stripe` gesetzt ist; sonst bleibt es beim Testweg (`test`). Ein Schlüssel ohne `sk_test_` (oder `rk_test_`) wird abgewiesen, in Produktion lehnt die Anwendung Stripe ganz ab. Kartendaten berühren die Anwendung nie, bezahlt wird bei Stripe. + +**Ablauf:** Bestellung anlegen, „Jetzt bezahlen (Stripe-Testmodus)“, Weiterleitung zur Stripe-Kasse. Freigeschaltet wird erst durch die signierte Meldung von Stripe an `POST /stripe/webhook` (Ereignis `checkout.session.completed`). Betrag und Währung werden gegen die Bestellung geprüft; wiederholte Meldungen schalten nichts doppelt frei. Eine Zahlung mit falschem Betrag oder auf eine nicht mehr offene Bestellung schaltet nichts frei und steht als Zahlung mit Status `zu_pruefen` in der Bestellung. + +**Einrichten (Test):** + +1. In Stripe den Testmodus („Sandbox“) wählen. Unter Entwickler > API-Schlüssel den Geheimschlüssel `sk_test_…` kopieren. +2. Unter Entwickler > Webhooks einen Endpunkt anlegen: URL `https://dev.laraundfelix.de/stripe/webhook`, Ereignisse `checkout.session.completed`, `checkout.session.expired`, `checkout.session.async_payment_succeeded`, `checkout.session.async_payment_failed`. Das Signiergeheimnis `whsec_…` des Endpunkts kopieren. +3. Auf llm-node in `/etc/luf/test.env` eintragen (Rechte `640`, nichts davon ins Repo, in Commits, Logs oder Chat): + + ``` + PAYMENT_DRIVER=stripe + STRIPE_SECRET=sk_test_... + STRIPE_WEBHOOK_SECRET=whsec_... + ``` + +4. In Gitea den letzten Lauf von „Deploy Test“ erneut starten (siehe „Env-Datei ändern“). `docker exec luf-test-app-1 printenv PAYMENT_DRIVER` muss `stripe` zeigen. +5. Testkauf mit der Stripe-Testkarte `4242 4242 4242 4242` (beliebiges künftiges Ablaufdatum, beliebige Prüfziffer). In Stripe unter Entwickler > Webhooks > Endpunkt > Ereignisse ist jede Zustellung samt Antwortcode zu sehen. + +**Zurück zum Testweg:** `PAYMENT_DRIVER=test` setzen und neu ausrollen. Offene Stripe-Bestellungen bleiben offen. + +**Grenzen:** Erstattungen laufen nicht über Stripe. Die Schaltfläche „Widerrufen“ ist im Stripe-Modus ausgeblendet; die Rückzahlung gehört zum Verkaufsstart (Live-Stripe, Belegprozess, Rückabwicklung). Steuer, Rechnung, Rabattcodes und Rechtstexte sind nicht Teil der Sandbox. ## Trennung Test und Prod (beide auf llm-node) | | Test | Prod | diff --git a/resources/views/member/order.blade.php b/resources/views/member/order.blade.php index 5d3b1aa..39da3b3 100644 --- a/resources/views/member/order.blade.php +++ b/resources/views/member/order.blade.php @@ -19,6 +19,11 @@ @endif

Status: {{ $statusText }}

+ @if ($order->status === 'offen' && $zahlung === 'zurueck') +

Danke. Wir warten auf die Bestätigung von Stripe. Sobald sie da ist, steht die Bestellung auf „Bezahlt“. Status neu laden

+ @elseif ($order->status === 'offen' && $zahlung === 'abbruch') +

Die Zahlung wurde abgebrochen. Es wurde nichts abgebucht. Du kannst erneut bezahlen.

+ @endif
Lizenzinhaber
{{ $order->party?->display_name }}
Bestellt von
{{ $order->user?->name }}
@@ -32,6 +37,12 @@ @endforeach

Summe: {{ \App\Domain\Commerce\Money::format($order->total_cents ?? $order->lines->sum('price_cents')) }}

+ @if ($stripePayment && $order->status === 'offen') +
+ @csrf + +
+ @endif @if ($testPayment && $order->status === 'offen')
@csrf @@ -44,9 +55,11 @@ @endif @if ($order->status === 'bezahlt')

Zur Bibliothek

- - @csrf - -
+ @if (! $stripePayment) +
+ @csrf + +
+ @endif @endif @endsection diff --git a/routes/web.php b/routes/web.php index dcaeeb7..09a2712 100644 --- a/routes/web.php +++ b/routes/web.php @@ -14,6 +14,7 @@ use App\Http\Controllers\PublicCatalogController; use App\Http\Controllers\PublicMediaController; use App\Http\Controllers\ShopController; +use App\Http\Controllers\StripeWebhookController; use App\Http\Controllers\ThemeController; use App\Http\Controllers\WebsiteMediaController; use App\Http\Middleware\EnsureShopEnabled; @@ -42,6 +43,8 @@ }); }); +Route::post('/stripe/webhook', StripeWebhookController::class)->name('stripe.webhook'); + Route::middleware('guest')->group(function () { Route::get('/registrieren', [RegistrationController::class, 'create'])->name('register'); Route::post('/registrieren', [RegistrationController::class, 'store']); @@ -121,6 +124,7 @@ Route::post('/angebote/{offer}/abrufen', [CheckoutController::class, 'claim'])->name('offers.claim'); Route::post('/angebote/{offer}/kaufen', [CheckoutController::class, 'place'])->name('offers.buy'); Route::get('/bestellung/{order}', [CheckoutController::class, 'show'])->name('order'); + Route::post('/bestellung/{order}/bezahlen', [CheckoutController::class, 'pay'])->name('order.pay'); Route::post('/bestellung/{order}/bestaetigen', [CheckoutController::class, 'confirm'])->name('order.confirm'); Route::post('/bestellung/{order}/ablehnen', [CheckoutController::class, 'fail'])->name('order.fail'); Route::post('/bestellung/{order}/widerrufen', [CheckoutController::class, 'refund'])->name('order.refund'); diff --git a/tests/Feature/CmsSectionRenderingTest.php b/tests/Feature/CmsSectionRenderingTest.php index 12cfc26..2431023 100644 --- a/tests/Feature/CmsSectionRenderingTest.php +++ b/tests/Feature/CmsSectionRenderingTest.php @@ -136,7 +136,7 @@ public function test_public_page_is_identical_for_guests_and_members(): void public function test_global_layout_has_header_navigation_mobile_menu_and_footer(): void { // Der Warenkorb gehört zum Shop (Etappe 1, nur Testzahlung). Ohne aktiven Shop erscheint kein Kaufknopf. - config(['services.payment.driver' => 'stripe']); + config(['services.payment.driver' => 'unbekannt']); $html = $this->get('/praevention')->assertOk()->getContent(); $this->assertStringContainsString('