Dokumentiere die Stripe-Sandbox-Abnahme und die Stolpersteine der Einrichtung
CI Feature / test (push) Successful in 1m39s

Bestellung 7 wurde über die Stripe-Kasse im Testmodus bezahlt und per Webhook freigeschaltet.
Betriebsdoku um die erlebten Stolpersteine ergänzt (pk_ statt sk_, Managed Payments, inklusiver
Steuersatz, Neuausrollen, Fehlersuche im Protokoll).

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
This commit is contained in:
StommerandClaude Sonnet 5.5 committed 2026-11-22 10:26:13 +01:00
1 parent 2ca7a8b268
commit f54acd55e6
4 files changed
+10

No files matched your search

+8
View File
@@ -51,6 +51,14 @@ ## Stripe-Sandbox (nur Test, Etappe 1)
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.
**Stolpersteine bei der ersten Einrichtung (21./22.11.2026 erlebt):**
- `STRIPE_SECRET` muss der **geheime** Schlüssel `sk_test_…` sein, nicht der veröffentlichbare `pk_test_…`. Die Anwendung weist alles andere vor dem Aufruf ab („Etappe 1 erlaubt nur den Stripe-Testmodus“).
- **Managed Payments** im Stripe-Konto verlangt für jedes Produkt einen Produkt-Steuercode (Fehler „Product tax code is required for Managed Payments“). Für die Sandbox wurde Managed Payments deaktiviert. Ein manueller Steuersatz (`txr_…`) ersetzt den Steuercode nicht.
- Der optionale Steuersatz `STRIPE_TAX_RATE_ID` muss im Preis **enthalten** (inklusiv) angelegt sein. In der Stripe-Kasse erscheint dann „Umsatzsteuer (19 % inklusive)“ und die Gesamtsumme bleibt gleich der Bestellsumme.
- Eine Änderung in `test.env` wirkt erst nach dem erneuten Lauf „Deploy Test“ (siehe oben). Die Variablennamen im Container zeigt `docker inspect -f '{{range .Config.Env}}{{println .}}{{end}}' luf-test-app-1 | sed 's/=.*//'`, ohne Werte.
- Warum Stripe eine Anfrage ablehnt, steht im App-Protokoll: `docker logs luf-test-app-1 --tail 300 2>&1 | grep 'Stripe-Anfrage'` (Status, Typ, Parameter und Begründung, keine Schlüssel).
**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.