Register Paddle sandbox webhooks

docs/ops/billing-ops.md

@@ -107,6 +107,31 @@ Diese Sektion ist bewusst generisch gehalten, damit sie auch nach Implementation
   - Bei `transaction.failed` / `transaction.cancelled`:
     - Session wird auf `failed` gesetzt, Coupons werden als fehlgeschlagen markiert.
 
+### 6.2.1 Sandbox‑Webhook registrieren
+
+- Command (Sandbox-Umgebung aktiv):
+  - `php artisan paddle:webhooks:register --traffic-source=simulation`
+- Optional mit URL-Override:
+  - `php artisan paddle:webhooks:register --url=https://staging.example.com/paddle/webhook --traffic-source=simulation`
+- Event‑Liste kommt aus `config/paddle.php` (`webhook_events`). Override möglich:
+  - `php artisan paddle:webhooks:register --events=transaction.completed --events=subscription.created`
+
+### 6.2.2 Verarbeitete Paddle-Events
+
+Die Webhook‑Handler erwarten mindestens diese Events:
+
+- `transaction.created`
+- `transaction.processing`
+- `transaction.completed` (inkl. Add-ons/Gift‑Vouchers)
+- `transaction.failed`
+- `transaction.cancelled`
+- `subscription.created`
+- `subscription.updated`
+- `subscription.paused`
+- `subscription.resumed`
+- `subscription.cancelled`
+- `subscription.past_due`
+
 ### 6.3 Subscriptions & TenantPackages
 
 - Subscription‑Events (`subscription.*`) werden ebenfalls von `CheckoutWebhookService` behandelt: