Binde Stripe im Testmodus an die Kasse an
CI Feature / test (push) Successful in 1m53s

Neuer Zahlungsweg PAYMENT_DRIVER=stripe: Checkout Session über die Stripe-API (Http-Client, kein
SDK), Freischaltung nur durch die signierte Meldung an POST /stripe/webhook (Signatur und
Zeittoleranz geprüft, Betrag und Währung gegen die Bestellung, wiederholte Meldung wirkungslos).
Nur Testschlüssel (sk_test_), nie in Produktion; Standard bleibt der Testweg. Die Freischaltung
nutzt denselben Weg wie die Testzahlung (Checkout::settle). Die Schaltfläche „Widerrufen“ ist im
Stripe-Modus ausgeblendet, weil sie kein Geld zurückbucht. Betrieb: docs/betrieb/DEPLOYMENT.md.

Bestandstests geändert: ShopProductPageTest und CmsSectionRenderingTest (2 Stellen) nutzten
„stripe“ als Beispiel für einen nicht freigegebenen Zahlungsweg. Stripe ist jetzt freigegeben,
die Tests nehmen den unbekannten Treiber „unbekannt“; die Assertions bleiben unverändert.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
This commit is contained in:
StommerandClaude Sonnet 5.5 committed 2026-11-21 22:26:09 +01:00
1 parent 604e1791c5
commit 9f7c645baf
15 files changed
+752 -15

No files matched your search

+27 -6
View File
@@ -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;
+12 -1
View File
@@ -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';
}
}
@@ -0,0 +1,145 @@
<?php
namespace App\Domain\Commerce\Stripe;
use App\Domain\Catalog\DomainRuleException;
use App\Domain\Commerce\Order;
use Illuminate\Http\Client\ConnectionException;
use Illuminate\Http\Client\PendingRequest;
use Illuminate\Http\Client\Response;
use Illuminate\Support\Facades\Http;
use Illuminate\Support\Facades\Log;
/**
* Stripe-Kasse (Checkout Session) für die Testzahlung in Etappe 1. Ausschließlich Testschlüssel: Ein Live-Schlüssel
* oder die Produktionsumgebung werden abgewiesen, bevor ein Aufruf an Stripe geht. Bezahlt wird bei Stripe; Kartendaten
* berühren diese Anwendung nie. Die Freischaltung erfolgt allein über die signierte Meldung (StripeWebhook).
*/
class StripeGateway
{
/**
* Legt für die Bestellung eine Checkout Session an oder liefert die noch offene wieder.
*
* @return array{id: string, url: string}
*/
public function checkoutFor(Order $order): array
{
$this->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.');
}
}
@@ -0,0 +1,59 @@
<?php
namespace App\Domain\Commerce\Stripe;
use App\Domain\Catalog\DomainRuleException;
/**
* Prüft die Signatur einer Stripe-Meldung (Header „Stripe-Signature“: t=Zeit, v1=HMAC-SHA256 über „t.Nutzlast“).
* Eine Meldung ohne gültige Signatur oder außerhalb der Zeittoleranz wird abgewiesen.
*/
class StripeSignature
{
public const TOLERANCE_SECONDS = 300;
public function verify(string $payload, ?string $header, ?int $now = null): void
{
$secret = (string) config('services.stripe.webhook_secret');
if ($secret === '') {
throw new DomainRuleException('Das Webhook-Geheimnis ist nicht eingerichtet.');
}
if ($header === null || trim($header) === '') {
throw new DomainRuleException('Die Signatur fehlt.');
}
$timestamp = null;
$signatures = [];
foreach (explode(',', $header) as $part) {
[$key, $value] = array_pad(explode('=', trim($part), 2), 2, '');
if ($key === 't') {
$timestamp = ctype_digit($value) ? (int) $value : null;
} elseif ($key === 'v1' && $value !== '') {
$signatures[] = $value;
}
}
if ($timestamp === null || $signatures === []) {
throw new DomainRuleException('Die Signatur ist unvollständig.');
}
$expected = hash_hmac('sha256', $timestamp.'.'.$payload, $secret);
$valid = false;
foreach ($signatures as $signature) {
$valid = hash_equals($expected, $signature) || $valid;
}
if (! $valid) {
throw new DomainRuleException('Die Signatur stimmt nicht.');
}
if (abs(($now ?? now()->getTimestamp()) - $timestamp) > self::TOLERANCE_SECONDS) {
throw new DomainRuleException('Die Meldung ist zu alt.');
}
}
}