From 4bc2e5871bc0c782f996a2e7c34073e1fd65a462 Mon Sep 17 00:00:00 2001 From: Stommer Date: Sun, 22 Nov 2026 08:37:34 +0100 Subject: [PATCH] Gib Stripe auf Wunsch einen im Preis enthaltenen Steuersatz je Position mit MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Stripe lehnte die Checkout Session mit „Invalid line_items[0]: the product tax code is missing“ ab. Neue optionale Einstellung STRIPE_TAX_RATE_ID (txr_...): Der Steuersatz wird jeder Position mitgegeben. Eine ungültige ID wird vor jedem Aufruf abgewiesen. Der Satz muss in Stripe inklusiv angelegt sein, damit der gezahlte Betrag der Bestellsumme entspricht (die Betragsprüfung bleibt). Die Anwendung wählt keinen Satz; das entscheiden Steuer und Finance. Doku und env-Beispiel ergänzt. Co-Authored-By: Claude Sonnet 5.5 --- app/Domain/Commerce/Stripe/StripeGateway.php | 21 ++++++++++++ config/services.php | 3 ++ deploy/luf.env.example | 1 + docs/betrieb/DEPLOYMENT.md | 3 ++ tests/Feature/StripeSandboxTest.php | 34 ++++++++++++++++++++ 5 files changed, 62 insertions(+) diff --git a/app/Domain/Commerce/Stripe/StripeGateway.php b/app/Domain/Commerce/Stripe/StripeGateway.php index fc3aa00..af84eb9 100644 --- a/app/Domain/Commerce/Stripe/StripeGateway.php +++ b/app/Domain/Commerce/Stripe/StripeGateway.php @@ -26,6 +26,7 @@ public function checkoutFor(Order $order): array { $this->assertSandbox(); $order->loadMissing('lines', 'user'); + $taxRate = $this->taxRate(); if ($order->status !== 'offen') { throw new DomainRuleException('Diese Bestellung nimmt keine Zahlung mehr an.'); @@ -58,6 +59,10 @@ public function checkoutFor(Order $order): array 'product_data' => ['name' => filled($line->offer_name) ? (string) $line->offer_name : 'Lizenz'], ], ]; + + if ($taxRate !== null) { + $params['line_items'][$index]['tax_rates'] = [$taxRate]; + } } $response = $this->request() @@ -94,6 +99,22 @@ public function assertSandbox(): void } } + /** Konfigurierter Steuersatz oder null; eine ungültige ID wird abgewiesen, statt geraten zu werden. */ + private function taxRate(): ?string + { + $id = trim((string) config('services.stripe.tax_rate')); + + if ($id === '') { + return null; + } + + if (! preg_match('/^txr_[A-Za-z0-9]+$/', $id)) { + throw new DomainRuleException('Die Steuersatz-ID für Stripe ist ungültig (erwartet txr_...).'); + } + + return $id; + } + /** * @return array{id: string, url: string}|null */ diff --git a/config/services.php b/config/services.php index 785ee77..b6b02f4 100644 --- a/config/services.php +++ b/config/services.php @@ -36,6 +36,9 @@ 'stripe' => [ 'secret' => env('STRIPE_SECRET'), 'webhook_secret' => env('STRIPE_WEBHOOK_SECRET'), + // Optional: ID eines in Stripe angelegten Steuersatzes (txr_...), der jeder Position mitgegeben wird. + // Er muss im Preis enthalten (inklusiv) sein, sonst weicht der gezahlte Betrag von der Bestellung ab. + 'tax_rate' => env('STRIPE_TAX_RATE_ID'), 'api_base' => env('STRIPE_API_BASE', 'https://api.stripe.com'), ], diff --git a/deploy/luf.env.example b/deploy/luf.env.example index fd9abc4..45161db 100644 --- a/deploy/luf.env.example +++ b/deploy/luf.env.example @@ -32,5 +32,6 @@ MAIL_FROM_NAME="${APP_NAME}" PAYMENT_DRIVER=test # STRIPE_SECRET=sk_test_... (Entwickler > API-Schlüssel, Testmodus) # STRIPE_WEBHOOK_SECRET=whsec_... (Entwickler > Webhooks > Endpunkt > Signiergeheimnis) +# STRIPE_TAX_RATE_ID=txr_... (optional: in Stripe angelegter, im Preis enthaltener Steuersatz) # 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 7038e5b..8526aed 100644 --- a/docs/betrieb/DEPLOYMENT.md +++ b/docs/betrieb/DEPLOYMENT.md @@ -43,8 +43,11 @@ ## Stripe-Sandbox (nur Test, Etappe 1) PAYMENT_DRIVER=stripe STRIPE_SECRET=sk_test_... STRIPE_WEBHOOK_SECRET=whsec_... + STRIPE_TAX_RATE_ID=txr_... ``` + `STRIPE_TAX_RATE_ID` ist optional. Verlangt Stripe für die Positionen eine Steuerangabe (Fehler „the product tax code is missing“), wird der in Stripe angelegte Steuersatz jeder Position mitgegeben. Er muss **im Preis enthalten (inklusiv)** sein: Die Bestellsumme ist der Bruttobetrag, und bei einem aufschlagenden Satz weicht der gezahlte Betrag ab, sodass die Zahlung als `zu_pruefen` festgehalten wird und nichts freischaltet. Welcher Satz gilt, entscheiden Steuer und Finance, nicht die Anwendung. + 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. diff --git a/tests/Feature/StripeSandboxTest.php b/tests/Feature/StripeSandboxTest.php index d601a3b..e107742 100644 --- a/tests/Feature/StripeSandboxTest.php +++ b/tests/Feature/StripeSandboxTest.php @@ -85,6 +85,40 @@ public function test_paying_creates_a_checkout_session_with_the_order_amounts_an $this->assertSame('offen', $order->fresh()->status, 'Bezahlt wird erst durch die signierte Meldung.'); } + public function test_a_configured_tax_rate_is_sent_with_every_line_and_otherwise_none(): void + { + $order = $this->orderOf($this->tina(), [$this->privateKonflikte(), $this->privateGrenzen()]); + Http::fake(['stripe.test/v1/checkout/sessions' => Http::response(['id' => 'cs_test_s', 'url' => 'https://checkout.stripe.test/s'])]); + + $this->actingAs($this->tina())->post(route('member.order.pay', $order))->assertRedirect(); + Http::assertSent(function (HttpRequest $request): bool { + parse_str($request->body(), $body); + + return ! isset($body['line_items'][0]['tax_rates']) && ! isset($body['line_items'][1]['tax_rates']); + }); + + $order->payments()->delete(); + config(['services.stripe.tax_rate' => 'txr_Testsatz123']); + $this->actingAs($this->tina())->post(route('member.order.pay', $order))->assertRedirect(); + Http::assertSent(function (HttpRequest $request): bool { + parse_str($request->body(), $body); + + return ($body['line_items'][0]['tax_rates'] ?? null) === ['txr_Testsatz123'] + && ($body['line_items'][1]['tax_rates'] ?? null) === ['txr_Testsatz123']; + }); + } + + public function test_an_invalid_tax_rate_id_is_refused_before_any_call(): void + { + $order = $this->orderOf($this->tina(), [$this->privateKonflikte()]); + config(['services.stripe.tax_rate' => 'txcd_99999999']); + Http::fake(); + + $this->actingAs($this->tina())->post(route('member.order.pay', $order)) + ->assertSessionHasErrors(['payment' => 'Die Steuersatz-ID für Stripe ist ungültig (erwartet txr_...).']); + Http::assertNothingSent(); + } + public function test_an_open_session_is_reused(): void { $order = $this->orderOf($this->tina(), [$this->privateKonflikte()]);