mivita/app/Models/ShoppingPayment.php
Kevin e1da90ff91 Stripe-Integration (S0–S3): Einmalzahlungen über Stripe Checkout + Notfall-Go-Live
Wegen PAYONE-Ausfall vorgezogen live geschaltet: alle Einmalzahlungen
(Shop + Salescenter) laufen über Stripe Hosted Checkout, Abos sind bis
Phase S4 eingefroren.

- Provider-Abstraktion: PaymentProvider-Enum, PaymentGatewayInterface,
  PaymentProviderManager (Settings-Schalter, provider-treu je Bestand),
  PayoneGateway als unveränderter Adapter
- StripePaymentService: Checkout Session (eine Gesamtposition, Metadata,
  success/cancel-Redirects), StripeClientWrapper (lazy, Dark Launch),
  StripeCustomerService, StripeTransactionRecorder (client_secret-Redaction)
- Webhook /stripe/webhook: Signaturprüfung, Idempotenz über
  stripe_webhook_events (Crash-Retry-Reprocessing), txaction-Prioritäten,
  Betrags-Guard, lockForUpdate-Paid-Pfad, genau eine Bestätigungsmail
- Zahlungsmethoden-Anzeige aus charge.succeeded (carddata inkl. Wallet,
  auftragsunabhängiges Backfill aus dem Event-Store)
- Checkout: Wartungsmodus mit Admin-Bypass, Abo-Freeze-Hinweis,
  Stripe-Option (Online-Zahlung) statt Zahlartenwahl, Vorkasse ausblendbar
- Abo-Freeze-Guards: Cron user:make_abo_order, Retry, Kartenupdate
- Admin-Settings-Karte Zahlungen (Provider, Wartung, Freeze, Vorkasse)
- Hotfix: 500 bei Vorkasse ohne Clearing-Daten in admin/sales/_detail
  und checkout-final (PAYONE-Ausfall)
- Doku dev/2026-07-08-stripe/ (Plan S0–S8, Konzept, IST-Analyse)

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-08 15:56:41 +00:00

170 lines
6.1 KiB
PHP

<?php
namespace App\Models;
use App\Services\Util;
use Illuminate\Database\Eloquent\Collection;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Support\Carbon;
/**
* App\Models\ShoppingPayment
*
* @property int $id
* @property int $shopping_order_id
* @property string $clearingtype
* @property string|null $wallettype
* @property string|null $onlinebanktransfertype
* @property string $reference
* @property int $amount
* @property string $currency
* @property string|null $status
* @property string|null $txaction
* @property Carbon|null $created_at
* @property Carbon|null $updated_at
* @property-read Collection|PaymentTransaction[] $payment_transactions
* @property-read int|null $payment_transactions_count
* @property-read ShoppingOrder $shopping_order
*
* @method static \Illuminate\Database\Eloquent\Builder|\App\Models\ShoppingPayment newModelQuery()
* @method static \Illuminate\Database\Eloquent\Builder|\App\Models\ShoppingPayment newQuery()
* @method static \Illuminate\Database\Eloquent\Builder|\App\Models\ShoppingPayment query()
* @method static \Illuminate\Database\Eloquent\Builder|\App\Models\ShoppingPayment whereAmount($value)
* @method static \Illuminate\Database\Eloquent\Builder|\App\Models\ShoppingPayment whereClearingtype($value)
* @method static \Illuminate\Database\Eloquent\Builder|\App\Models\ShoppingPayment whereCreatedAt($value)
* @method static \Illuminate\Database\Eloquent\Builder|\App\Models\ShoppingPayment whereCurrency($value)
* @method static \Illuminate\Database\Eloquent\Builder|\App\Models\ShoppingPayment whereId($value)
* @method static \Illuminate\Database\Eloquent\Builder|\App\Models\ShoppingPayment whereOnlinebanktransfertype($value)
* @method static \Illuminate\Database\Eloquent\Builder|\App\Models\ShoppingPayment whereReference($value)
* @method static \Illuminate\Database\Eloquent\Builder|\App\Models\ShoppingPayment whereShoppingOrderId($value)
* @method static \Illuminate\Database\Eloquent\Builder|\App\Models\ShoppingPayment whereStatus($value)
* @method static \Illuminate\Database\Eloquent\Builder|\App\Models\ShoppingPayment whereTxaction($value)
* @method static \Illuminate\Database\Eloquent\Builder|\App\Models\ShoppingPayment whereUpdatedAt($value)
* @method static \Illuminate\Database\Eloquent\Builder|\App\Models\ShoppingPayment whereWallettype($value)
*
* @property string|null $mode
*
* @method static \Illuminate\Database\Eloquent\Builder|\App\Models\ShoppingPayment whereMode($value)
*
* @property array|null $carddata
* @property int|null $is_abo
* @property int|null $abo_interval
*
* @method static \Illuminate\Database\Eloquent\Builder|ShoppingPayment whereAboInterval($value)
* @method static \Illuminate\Database\Eloquent\Builder|ShoppingPayment whereCarddata($value)
* @method static \Illuminate\Database\Eloquent\Builder|ShoppingPayment whereIsAbo($value)
*
* @property string|null $identifier
*
* @method static \Illuminate\Database\Eloquent\Builder<static>|ShoppingPayment whereIdentifier($value)
*
* @mixin \Eloquent
*/
class ShoppingPayment extends Model
{
protected $table = 'shopping_payments';
protected $casts = [
'carddata' => 'array',
];
protected $fillable = [
'shopping_order_id',
'payment_provider',
'external_reference',
'clearingtype',
'wallettype',
'onlinebanktransfertype',
'carddata',
'reference',
'amount',
'currency',
'mode',
'is_abo',
'abo_interval',
'identifier',
];
public function shopping_order()
{
return $this->belongsTo('App\Models\ShoppingOrder', 'shopping_order_id');
}
public function payment_transactions()
{
return $this->hasMany('App\Models\PaymentTransaction', 'shopping_payment_id');
}
public function getPaymentType()
{
if ($this->payment_provider === 'stripe') {
return $this->stripePaymentTypeLabel();
}
if ($this->clearingtype === 'wlt') {
if ($this->wallettype === 'PPE') {
return __('payment.paypal');
}
}
if ($this->clearingtype === 'cc') {
return __('payment.credit_card');
}
if ($this->clearingtype === 'vor') {
return __('payment.prepayment');
}
if ($this->clearingtype === 'elv') {
return __('payment.sepa_direct_debit');
}
if ($this->clearingtype === 'sb') {
if ($this->onlinebanktransfertype === 'PNT') {
return __('payment.sofort_bank_transfer');
}
}
if ($this->clearingtype === 'fnc') {
if ($this->onlinebanktransfertype === 'MIV') {
return __('payment.purchase_on_account');
}
}
return __('payment.unknown');
}
public function getPaymentAmount()
{
return Util::formatNumber($this->amount / 100).' '.$this->currency;
}
/**
* Anzeige-Label für Stripe-Zahlungen aus den gespeicherten
* payment_method_details (StripeWebhookHandler::storePaymentMethodDetails).
*/
private function stripePaymentTypeLabel(): string
{
$details = is_array($this->carddata) ? $this->carddata : [];
$type = $details['type'] ?? null;
$cardSuffix = ! empty($details['brand']) && ! empty($details['last4'])
? ' ('.ucfirst($details['brand']).' •••• '.$details['last4'].')'
: '';
if ($type === 'card') {
$wallet = $details['wallet'] ?? null;
if ($wallet === 'apple_pay') {
return 'Apple Pay'.$cardSuffix;
}
if ($wallet === 'google_pay') {
return 'Google Pay'.$cardSuffix;
}
return __('payment.credit_card').$cardSuffix;
}
return match ($type) {
'paypal' => __('payment.paypal'),
'klarna' => 'Klarna',
'amazon_pay' => 'Amazon Pay',
'sepa_debit' => __('payment.sepa_direct_debit').(! empty($details['last4']) ? ' (•••• '.$details['last4'].')' : ''),
default => __('payment.stripe_online_short'),
};
}
}