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:
parent
30fb031d12
commit
68d230d4e5
31 changed files with 3612 additions and 65 deletions
177
app/Services/ManualPaymentService.php
Normal file
177
app/Services/ManualPaymentService.php
Normal file
|
|
@ -0,0 +1,177 @@
|
|||
<?php
|
||||
|
||||
namespace App\Services;
|
||||
|
||||
use App\Exceptions\ManualPaymentException;
|
||||
use App\Models\PaymentTransaction;
|
||||
use App\Models\ShoppingOrder;
|
||||
use App\Models\ShoppingPayment;
|
||||
use App\User;
|
||||
use Illuminate\Support\Facades\DB;
|
||||
use Illuminate\Support\Facades\Log;
|
||||
|
||||
/**
|
||||
* Erfasst einen Zahlungseingang, den kein Zahlungsanbieter melden kann
|
||||
* (Plan dev/2026-08-26-stripe/, Phase SE4).
|
||||
*
|
||||
* Anlass (Buchhaltung, Mail 2026-08-26): Bei **Vorkasse über PAYONE** schreiben
|
||||
* Kunden regelmäßig einen falschen Verwendungszweck auf die Überweisung.
|
||||
* PAYONE kann den Eingang dann nicht automatisch zuordnen, und die Buchhaltung
|
||||
* musste die Rechnung bisher von Hand schreiben — der bestehende
|
||||
* Status-Button setzte nur `paid`, ohne Rechnung, Punkte, Abo-Aktivierung
|
||||
* oder Mail auszulösen.
|
||||
*
|
||||
* Dieser Service läuft durch **denselben** Paid-Pfad wie ein Anbieter-Callback
|
||||
* ({@see Payment::paymentStatusPaidAction}) und protokolliert den Vorgang
|
||||
* revisionssicher: Wer hat wann welchen Betrag mit welchem Beleg erfasst.
|
||||
*/
|
||||
class ManualPaymentService
|
||||
{
|
||||
public const METHOD_BANK_TRANSFER = 'bank_transfer';
|
||||
|
||||
public const METHOD_CASH = 'cash';
|
||||
|
||||
public const METHOD_OTHER = 'other';
|
||||
|
||||
/**
|
||||
* Zahlungswege für das Erfassungsformular.
|
||||
*
|
||||
* @return array<string, string>
|
||||
*/
|
||||
public static function methods(): array
|
||||
{
|
||||
return [
|
||||
self::METHOD_BANK_TRANSFER => __('payment.manual_method_bank_transfer'),
|
||||
self::METHOD_CASH => __('payment.manual_method_cash'),
|
||||
self::METHOD_OTHER => __('payment.manual_method_other'),
|
||||
];
|
||||
}
|
||||
|
||||
/**
|
||||
* Verbucht den Zahlungseingang und löst alle Folgeschritte aus:
|
||||
* Rechnung, Umsatz/Punkte, Abo-Aktivierung und Bestätigungsmail.
|
||||
*
|
||||
* @param array{amount_cents: int, paid_at: string, method: string, bank_reference: string, note?: string|null, send_mail?: bool} $data
|
||||
*
|
||||
* @throws ManualPaymentException
|
||||
*/
|
||||
public function recordIncomingPayment(
|
||||
ShoppingOrder $shoppingOrder,
|
||||
ShoppingPayment $shoppingPayment,
|
||||
array $data,
|
||||
?User $admin = null,
|
||||
): PaymentTransaction {
|
||||
if ((int) $shoppingPayment->shopping_order_id !== (int) $shoppingOrder->id) {
|
||||
throw new ManualPaymentException(__('payment.manual_error_payment_mismatch'));
|
||||
}
|
||||
if ($shoppingOrder->paid) {
|
||||
throw new ManualPaymentException(__('payment.manual_error_already_paid'));
|
||||
}
|
||||
if (in_array($shoppingOrder->txaction, ['cancelled'], true)) {
|
||||
throw new ManualPaymentException(__('payment.manual_error_cancelled'));
|
||||
}
|
||||
|
||||
$sendLink = false;
|
||||
|
||||
$transaction = DB::transaction(function () use ($shoppingOrder, $shoppingPayment, $data, $admin, &$sendLink) {
|
||||
// Gegen Doppelklick und parallelen Anbieter-Callback absichern —
|
||||
// gleiches Muster wie im Stripe-/PAYONE-Webhook.
|
||||
$lockedOrder = ShoppingOrder::where('id', $shoppingOrder->id)->lockForUpdate()->first();
|
||||
|
||||
if ($lockedOrder->paid) {
|
||||
throw new ManualPaymentException(__('payment.manual_error_already_paid'));
|
||||
}
|
||||
|
||||
$transaction = PaymentTransaction::create([
|
||||
'shopping_payment_id' => $shoppingPayment->id,
|
||||
'provider' => 'manual',
|
||||
'request' => 'manual_payment',
|
||||
'txid' => 0,
|
||||
'userid' => 0,
|
||||
'status' => 'MANUAL',
|
||||
'txaction' => 'paid',
|
||||
'transmitted_data' => $this->auditPayload($shoppingPayment, $data, $admin),
|
||||
'mode' => $shoppingPayment->mode,
|
||||
]);
|
||||
|
||||
$shoppingPayment->txaction = 'paid';
|
||||
$shoppingPayment->save();
|
||||
$lockedOrder->txaction = 'paid';
|
||||
$lockedOrder->save();
|
||||
|
||||
$sendLink = Payment::paymentStatusPaidAction($lockedOrder, true, $shoppingPayment);
|
||||
|
||||
return $transaction;
|
||||
});
|
||||
|
||||
if (! empty($data['send_mail'])) {
|
||||
Payment::paymentStatusSendMail($shoppingOrder->fresh(), $shoppingPayment, [
|
||||
'txaction' => 'paid',
|
||||
'mode' => $shoppingPayment->mode,
|
||||
'send_link' => $sendLink,
|
||||
]);
|
||||
}
|
||||
|
||||
$this->logAction($shoppingOrder, $shoppingPayment, $data, $admin);
|
||||
|
||||
return $transaction;
|
||||
}
|
||||
|
||||
/**
|
||||
* Revisionsspur: Was wurde erfasst, von wem, und weicht der Betrag ab.
|
||||
*
|
||||
* @param array<string, mixed> $data
|
||||
* @return array<string, mixed>
|
||||
*/
|
||||
private function auditPayload(ShoppingPayment $shoppingPayment, array $data, ?User $admin): array
|
||||
{
|
||||
$amountCents = (int) $data['amount_cents'];
|
||||
|
||||
return [
|
||||
'source' => 'admin_manual_payment',
|
||||
'amount_cents' => $amountCents,
|
||||
'expected_cents' => (int) $shoppingPayment->amount,
|
||||
'amount_matches' => $amountCents === (int) $shoppingPayment->amount,
|
||||
'paid_at' => $data['paid_at'],
|
||||
'method' => $data['method'],
|
||||
'bank_reference' => $data['bank_reference'],
|
||||
'note' => $data['note'] ?? null,
|
||||
'recorded_by_user_id' => $admin?->id,
|
||||
'recorded_by_email' => $admin?->email,
|
||||
'recorded_at' => now()->toDateTimeString(),
|
||||
];
|
||||
}
|
||||
|
||||
/**
|
||||
* @param array<string, mixed> $data
|
||||
*/
|
||||
private function logAction(ShoppingOrder $shoppingOrder, ShoppingPayment $shoppingPayment, array $data, ?User $admin): void
|
||||
{
|
||||
$message = sprintf(
|
||||
'Zahlungseingang manuell erfasst: %s (Beleg: %s, Zahlungsweg: %s, Zahlung #%d)',
|
||||
Util::formatNumber(((int) $data['amount_cents']) / 100).' '.$shoppingPayment->currency,
|
||||
$data['bank_reference'],
|
||||
$data['method'],
|
||||
$shoppingPayment->id,
|
||||
);
|
||||
|
||||
try {
|
||||
SysLog::action('manual-payment', 'payment', 3)
|
||||
->setModel($shoppingOrder->id, ShoppingOrder::class)
|
||||
->setUserId($admin?->id)
|
||||
->setMessage($message)
|
||||
->save();
|
||||
} catch (\Throwable $e) {
|
||||
// Das Protokoll darf die Buchung nicht kippen — sie ist bereits committed.
|
||||
Log::channel('payment')->error('SysLog für manuellen Zahlungseingang fehlgeschlagen: '.$e->getMessage(), [
|
||||
'shopping_order_id' => $shoppingOrder->id,
|
||||
]);
|
||||
}
|
||||
|
||||
Log::channel('payment')->info($message, [
|
||||
'shopping_order_id' => $shoppingOrder->id,
|
||||
'shopping_payment_id' => $shoppingPayment->id,
|
||||
'recorded_by_user_id' => $admin?->id,
|
||||
]);
|
||||
}
|
||||
}
|
||||
Loading…
Add table
Add a link
Reference in a new issue