managarten/apps/uload/docs/stripe/testing-checklist.md

Stripe Subscription Testing Checklist

🔧 Setup für Tests

1. Test-Umgebung

• Dev Server läuft (npm run dev)
• Test-Keys sind eingetragen (nicht Live-Keys!)
• Stripe CLI installiert: brew install stripe/stripe-cli/stripe
• Webhook listening: stripe listen --forward-to localhost:5173/api/stripe/webhook

2. Test User anlegen

# In PocketBase Admin (http://localhost:8090/_/)
1. Users Collection öffnen
2. Neuen User erstellen:
   - Email: test@example.com
   - Password: testtest
   - subscription_status: "free"
   - links_count: 0

💳 1. Checkout Flow testen

Monthly Subscription

• Auf /pricing gehen
• "Monthly" Button klicken
• Stripe Checkout öffnet sich
• Korrekter Preis: €4.99/month
• Test-Karte: 4242 4242 4242 4242
• Payment erfolgreich

Yearly Subscription

• "Yearly" Button testen
• Korrekter Preis: €39.99/year
• Payment erfolgreich

Lifetime Payment

• "Lifetime" Button testen
• Korrekter Preis: €129.99 (one-time)
• Payment erfolgreich

🔗 2. Webhook Testing

Manuell mit Stripe CLI

# Webhook Event simulieren
stripe trigger checkout.session.completed

# Logs checken:
# 1. Terminal wo stripe listen läuft
# 2. Browser Konsole
# 3. PocketBase für User-Update

Automatisch nach echtem Payment

• Payment durchführen
• Webhook wird automatisch ausgelöst
• User Status wird auf "pro" gesetzt
• stripe_customer_id wird gespeichert

👤 3. User Status Testing

Free User Limits

# Als Free User einloggen
# Versuche 11 Links zu erstellen

• Link 1-10: Erfolgreich erstellt
• Link 11: Error "Limit erreicht"
• Upgrade-Button wird angezeigt

Pro User Unlimited

• User auf "pro" setzen (manuell in PocketBase)
• Beliebig viele Links erstellen können
• Kein Limit-Check

🎛️ 4. Subscription Management

Status Check API

curl http://localhost:5173/api/user/subscription

• Gibt aktuellen Status zurück
• Zeigt nächste Zahlung an (falls recurring)

Cancel Subscription

• Stripe Customer Portal Link funktioniert
• Subscription kann gekündigt werden
• User Status wird entsprechend geupdatet

🧪 5. Edge Cases testen

Doppelte Subscription

• Pro User versucht erneut zu upgraden
• Error: "Du hast bereits ein aktives Abo"

Abgebrochene Payments

• Payment abbrechen im Stripe Checkout
• User bleibt auf "free" Status
• Keine Änderungen in PocketBase

Webhook Failures

• Webhook URL temporär down
• Stripe retries automatisch
• Manual retry über Stripe Dashboard

📊 6. Integration Testing

Frontend Updates

• Navigation zeigt Pro-Status
• Upgrade-Buttons verschwinden für Pro User
• Richtige Limits werden angezeigt

API Protection

# Als Free User mit 10 Links
curl -X POST http://localhost:5173/api/links \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com"}'

• 403 Error bei Limit überschritten
• Pro User kann unbegrenzt erstellen

🎯 7. Test Cards für verschiedene Szenarien

Erfolgreiche Payments

• 4242 4242 4242 4242 - Visa
• 5555 5555 5555 4444 - Mastercard
• 4000 0025 0000 3155 - Visa (requires authentication)

Failed Payments

• 4000 0000 0000 0002 - Card declined
• 4000 0000 0000 9995 - Insufficient funds

SEPA Testing

• IBAN: DE89370400440532013000
• SEPA Direct Debit funktioniert

✅ Completion Checklist

• Alle Checkout-Flows funktionieren
• Webhooks verarbeiten Events korrekt
• User Status Updates funktionieren
• Link-Limits werden enforced
• Pro Features sind freigeschaltet
• Error Handling funktioniert
• Frontend zeigt korrekten Status

🚨 Häufige Probleme

Webhook nicht erhalten

# Check Stripe CLI Output
stripe listen --forward-to localhost:5173/api/stripe/webhook --log-level debug

User Status nicht geupdated

-- In PocketBase Admin Console
SELECT * FROM users WHERE email = 'test@example.com';

Payment fehlgeschlagen

• API Keys überprüfen (Test vs Live)
• Price IDs korrekt?
• Webhook Endpoint erreichbar?

---

Tipp: Teste immer mit Test-Daten und Test-Keys. Niemals echte Payments in der Entwicklung!