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