mivita/.env.example
Kevin ccc6f85809 Payment Phase R: PAYONE-Integration entflechten (R1–R7 + Review)
Strangler-Refactoring der PAYONE-Zahlungslogik in eine testbare
Service-Schicht, ohne Verhalten in Checkout/Cron/IPN zu ändern.

Neue Services (app/Services/Payment/Payone):
- PayonePaymentService (+ PayonePaymentResult-DTO) für CC-/SEPA-Check
  und Abo-Abbuchung
- PayoneRequestBuilder, PaymentMethodResolver, PayoneMethodConfig
- PayoneTransactionRecorder: zentrale PaymentTransaction-Erstellung
  (API-Response, Invoice, Webhook) inkl. PCI-Redaction (cardpan/cardcvc2)
- PayoneWebhookHandler (+ PayoneWebhookResult): IPN/TSOK-Logik aus
  Api\PayoneController; response('TSOK') statt echo/exit
- PayoneTransportException + Handler-Mapping (403) statt abort() im Service

Hotfixes (R1): var_dump/exit & bare exit() entfernt, Log-Redaction.

Security (R-Review):
- PAYONE_KEY_HASH (MD5-Hash, kein Klartext) mit Boot-Hard-Fail; schließt
  zugleich die ''-Webhook-Bypass-Lücke. Artisan-Command payone:hash-key
  (verdeckte Eingabe, optional --write) zur Hash-Erzeugung.
- Webhook: txaction Pflichtfeld, mode-Fallback auf payment->mode.

Pay\PayoneController ist @deprecated-Fassade (614 → 328 Zeilen),
delegiert an Services via Container-Singleton.

Migration: fehlende Spalte shopping_payments.carddata nachgezogen.

Tests: 47 grün (PayonePaymentService, Recorder, Webhook, Resolver,
TransportException, hash-key). End-to-End im Test-System verifiziert
(siehe dev/2026-06-09-payments).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-10 13:42:45 +00:00

100 lines
3.5 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=