mivita/.env.example
Kevin 6f21845607 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

113 lines
4.1 KiB
Text

# =============================================================================
# DHL VERSANDMODUL KONFIGURATION - BEISPIEL
# =============================================================================
# Diese Datei enthält alle DHL-spezifischen Environment-Variablen
# Kopieren Sie die benötigten Variablen in Ihre .env Datei
# =============================================================================
# DHL KONFIGURATION - PRIORITÄT
# =============================================================================
# Steuert, welche Konfigurationsquelle Vorrang hat:
# - 'database' (Standard): Werte aus Admin-Settings überschreiben .env Werte
# - 'env': .env Werte überschreiben Admin-Settings
#
# Nützlich für Test-Server, wo du .env Werte verwenden möchtest,
# ohne die Datenbank-Settings ändern zu müssen
DHL_CONFIG_SOURCE=database
# DHL API Zugangsdaten
# Option 1: DHL Developer API (developer.dhl.com) - Empfohlen
DHL_API_KEY=your_api_key_from_developer_dhl_com
DHL_API_SECRET=your_api_secret_from_developer_dhl_com
# Option 2: DHL Business Customer API (Klassisch)
DHL_API_USERNAME=your_dhl_username
DHL_API_PASSWORD=your_dhl_password
DHL_ACCOUNT_NUMBER=your_14_digit_account_number
# API-Konfiguration
DHL_SANDBOX=true # false für Produktion
DHL_TEST_MODE=true # false für Produktion
DHL_API_TYPE=developer # 'developer' oder 'business_customer'
# Absenderadresse (Ihre Firmenadresse)
DHL_SENDER_COMPANY="Ihr Firmenname"
DHL_SENDER_NAME="Versandabteilung"
DHL_SENDER_STREET="Ihre Straße"
DHL_SENDER_STREET_NUMBER=123
DHL_SENDER_POSTAL_CODE=12345
DHL_SENDER_CITY="Ihre Stadt"
DHL_SENDER_STATE=
DHL_SENDER_COUNTRY=DE
DHL_SENDER_EMAIL=versand@ihrefirma.de
DHL_SENDER_PHONE="+49 123 456789"
# Standard-Einstellungen
DHL_DEFAULT_PRODUCT=V01PAK # V01PAK = DHL Paket
DHL_LABEL_FORMAT=PDF # PDF oder ZPL
DHL_LABEL_SIZE=A4 # A4 oder 10x15cm
DHL_LABEL_STORAGE_PATH=storage/app/dhl/labels
DHL_LABEL_PUBLIC_PATH=dhl/labels
# Retouren
DHL_RETURNS_ENABLED=true
DHL_RETURN_PRODUCT=V07PAK # V07PAK = DHL Paket Return
DHL_RETURN_RECEIVER_ID=your_return_receiver_id
# Tracking
DHL_TRACKING_ENABLED=true
DHL_TRACKING_AUTO_UPDATE=true
DHL_TRACKING_UPDATE_INTERVAL=60 # Minuten
# Logging
DHL_LOGGING_ENABLED=true
DHL_LOGGING_LEVEL=info # debug, info, warning, error
DHL_LOG_REQUESTS=true
DHL_LOG_RESPONSES=true
# Queue (verwende bestehende Queue-Konfiguration)
DHL_QUEUE_CONNECTION=database
DHL_QUEUE_NAME=dhl
DHL_QUEUE_TIMEOUT=60
DHL_QUEUE_MAX_TRIES=3
# Fehlerbehandlung
DHL_THROW_EXCEPTIONS=true
DHL_ERROR_NOTIFICATION_EMAIL=admin@ihrefirma.de
# Cache
DHL_CACHE_ENABLED=true
DHL_CACHE_TTL=3600 # Sekunden
# Entwicklung/Testing
DHL_FAKE_API_CALLS=false # true um API-Calls zu simulieren
DHL_MOCK_RESPONSES=false # true um Mock-Responses zu verwenden
DHL_DEBUG_MODE=false # true für detaillierte Debug-Informationen
# Business Commands Configuration
# Erlaubt Business-Commands an jedem Tag (nur für Test-Server!)
# Auf Live-Server muss dies false sein oder weggelassen werden
BUSINESS_FORCE_EXECUTE=false
# =============================================================================
# PAYONE KONFIGURATION
# =============================================================================
PAYONE_URL=checkout.example.test
PAYONE_TS=checkout.example.test/transaction/status
# MD5-Hash des PAYONE-Portal-Keys (NICHT der Klartext-Key). Pflichtwert:
# Fehlt er, schlägt der Application-Boot bewusst hart fehl.
# Hash erzeugen (verdeckte Eingabe, schreibt optional direkt in die .env):
# php artisan payone:hash-key --write
PAYONE_KEY_HASH=
# =============================================================================
# STRIPE KONFIGURATION (dev/2026-07-08-stripe/)
# =============================================================================
# Secret Key (sk_test_… / sk_live_…). Kein Boot-Hard-Fail: ohne Key bleibt
# Stripe inaktiv; erst die Nutzung des StripeClientWrapper schlägt fehl.
STRIPE_SECRET=
# Publishable Key (pk_test_… / pk_live_…)
STRIPE_KEY=
# Webhook-Signing-Secret des Endpoints /api/stripe/webhook (whsec_…)
STRIPE_WEBHOOK_SECRET=
# test | live — muss zum Key-Paar passen
STRIPE_MODE=test