Stripe: Kundendaten, Rechnungsnummer, manueller Zahlungseingang

Rueckmeldung der Buchhaltung und des Stripe-Calls (dev/2026-08-26-stripe/):
Stripe kannte bisher nur die E-Mail des Kunden, Zahlungen waren im Dashboard
weder ueber die Bestell- noch ueber die Rechnungsnummer auffindbar, und ein
Zahlungseingang mit falschem Verwendungszweck zwang die Buchhaltung dazu, die
Rechnung von Hand zu schreiben.

- SE1: Der Checkout haengt einen Stripe-Customer mit Name, E-Mail und
  Rechnungsanschrift an die Session (customer statt customer_email); die ID
  liegt an shopping_users und wird wiederverwendet. Namensformat "Vorname
  Nachname (Firma)", reine Firmenkunden unter der Firma. Faellt die
  Customer-Anlage aus, laeuft der Checkout auf dem bisherigen Weg weiter.
  DSGVO-Loeschungen entfernen jetzt auch das Customer-Objekt; die Charges
  bleiben als Buchungsbeleg bestehen.
- SE2: StripeMetadataBuilder als einzige Quelle fuer Metadaten und die
  description (Bestellnummer, Referenz, Kundenname) - damit greift die
  Dashboard-Suche, die bisher nichts Lesbares zu fassen bekam.
- SE3: Die Rechnungsnummer entsteht erst nach der Zahlung und wird daher per
  Job am PaymentIntent nachgetragen (Vorab-Reservierung wuerde Luecken im
  Nummernkreis erzeugen). stripe:backfill-invoice-metadata traegt sie
  rueckwirkend ab dem Go-Live 2026-07-10 nach.
- SE4: Neuer Admin-Button "Zahlungseingang erfassen" an jeder unbezahlten
  Bestellung - bisher gab es ihn nur bei Rechnungskauf, und er setzte nur
  paid, ohne Rechnung, Punkte, Abo-Aktivierung oder Mail. Der neue Weg laeuft
  durch paymentStatusPaidAction, verlangt den Verwendungszweck als Beleg und
  laesst einen abweichenden Betrag nur mit ausdruecklicher Bestaetigung zu.
- S6.4 (aus dem Juli-Plan vorgezogen): stripe:sync-payment-status gleicht
  offene Zahlungen aktiv gegen die API ab. Aufgefallen beim Testlauf - ein nie
  zugestellter Webhook war bisher nicht reparierbar, das Geld lag bei Stripe
  waehrend die Bestellung auf offen stand. Laeuft stuendlich im Scheduler.
- 110 Tests (Pest) fuer alle Pfade, Stripe-Client durchgehend gemockt.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This commit is contained in:
Kevin 2026-08-28 09:04:28 +00:00
parent 30fb031d12
commit 68d230d4e5
31 changed files with 3612 additions and 65 deletions

View file

@ -219,4 +219,30 @@ return [
'packstation_alert_location' => 'Standort der Packstation',
'packstation_alert_not_home' => 'nicht Ihre Wohnadresse!',
'packstation_alert_footer' => 'Die Packstation-NUMMER ist 3-stellig (100-999, steht auf dem gelben Schild). Die DHL Postnummer ist 6-10-stellig und kommt ins separate Feld oben.',
// Zahlungseingang manuell erfassen (SE4, dev/2026-08-26-stripe/)
'manual_record_title' => 'Zahlungseingang erfassen',
'manual_record_button' => 'Zahlungseingang erfassen',
'manual_record_intro' => 'Für Zahlungen, die der Zahlungsanbieter nicht automatisch zuordnen konnte — z. B. eine Vorkasse-Überweisung mit falschem Verwendungszweck. Das System erstellt anschließend Rechnung, Umsatz/Punkte und die Bestätigungsmail wie bei einer regulären Zahlung.',
'manual_record_bank_hint' => 'Hinweis: Das Geld ist auf dem Bankkonto eingegangen, nicht beim Zahlungsanbieter. Der Vorgang taucht deshalb nicht in den Stripe-Berichten auf, sondern nur in Rechnung und DATEV-Export.',
'manual_paid_at' => 'Zahlungsdatum (Valuta)',
'manual_amount' => 'Erhaltener Betrag',
'manual_method' => 'Zahlungsweg',
'manual_method_bank_transfer' => 'Banküberweisung',
'manual_method_cash' => 'Bar',
'manual_method_other' => 'Sonstiges',
'manual_bank_reference' => 'Verwendungszweck / Bankreferenz',
'manual_bank_reference_help' => 'Pflichtfeld — dient als Beleg für die Buchung.',
'manual_note' => 'Notiz (optional)',
'manual_send_mail' => 'Bestätigungsmail an den Kunden senden',
'manual_confirm_deviation' => 'Abweichenden Betrag bewusst erfassen',
'manual_expected_amount' => 'Erwarteter Betrag',
'manual_recorded_by' => 'Manuell erfasst',
'manual_success' => 'Zahlungseingang wurde erfasst. Rechnung, Umsatz und Mail wurden ausgelöst.',
'manual_error_already_paid' => 'Diese Bestellung ist bereits als bezahlt erfasst.',
'manual_error_cancelled' => 'Diese Bestellung ist storniert und kann nicht als bezahlt erfasst werden.',
'manual_error_payment_mismatch' => 'Die Zahlung gehört nicht zu dieser Bestellung.',
'manual_error_reference_required' => 'Bitte den Verwendungszweck bzw. die Bankreferenz angeben — sie ist der Beleg für die Buchung.',
'manual_error_future_date' => 'Das Zahlungsdatum darf nicht in der Zukunft liegen.',
'manual_error_amount_deviation' => 'Der Betrag weicht vom Rechnungsbetrag (:expected) ab. Bitte die Abweichung bestätigen.',
'manual_error_general' => 'Der Zahlungseingang konnte nicht erfasst werden. Details stehen im Payment-Log.',
];