Files
laraundfelix/app/Domain/Commerce/Stripe/StripeGateway.php
T
StommerandClaude Sonnet 5.5 4bc2e5871b
CI Feature / test (push) Successful in 1m54s
Gib Stripe auf Wunsch einen im Preis enthaltenen Steuersatz je Position mit
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 <noreply@anthropic.com>
2026-11-22 08:37:34 +01:00

170 lines
6.1 KiB
PHP

<?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');
$taxRate = $this->taxRate();
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'],
],
];
if ($taxRate !== null) {
$params['line_items'][$index]['tax_rates'] = [$taxRate];
}
}
$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_).');
}
}
/** 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
*/
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;
}
// Statuscode, Fehlertyp, Code, betroffener Parameter und Begründung von Stripe, damit die Ursache lesbar ist.
// Nie Schlüssel oder Kundendaten; die Begründung wird gekürzt.
Log::warning('Stripe-Anfrage fehlgeschlagen', [
'status' => $response->status(),
'type' => $response->json('error.type'),
'code' => $response->json('error.code'),
'param' => $response->json('error.param'),
'message' => mb_substr((string) $response->json('error.message'), 0, 300),
]);
throw new DomainRuleException('Die Zahlung konnte bei Stripe nicht '.$what.' werden. Bitte versuche es später noch einmal.');
}
}