Zahlungsmethoden

Stripe-Checkout ist der primaere Zahlungsweg. Kreditkarte sofort, SEPA ueber Mollie (Phase 3, geplant fuer Pilotkunden ohne Kreditkarte).

Phase 2 · 1st-Level-Hilfe

Welche Zahlungsmethoden werden unterstuetzt?

Methode	Phase	Pilotkunden-Status
Kreditkarte (Visa, Mastercard, AmEx)	Phase 2 (live)	Funktioniert fuer Pilotkunden #1, #3 (JTL-Shop5), #4 (Stripe-Checkout).
SEPA-Lastschrift (Mollie)	Phase 3 (geplant)	Stub-Interface hinter IPaymentProvider bereits implementiert. Aktivierung, sobald Pilotkunde SEPA anfordert.
PayPal	Nicht geplant	Aktuell keine Pilotkunden-Anfrage. Bei Bedarf: ADR erforderlich.
Rechnung / Ueberweisung	Nicht geplant	Nur fuer Enterprise-Kunden denkbar (Phase 3+, separates ADR).
Multi-Currency (EUR/USD/CHF)	Phase 3	Aktuell nur EUR.

Wie aktualisiert der Kunde seine Zahlungsmethode?

Der Kunde kann seine Kreditkarte nicht direkt im sellx-Portal aendern — sellx speichert keine Payment-Daten. Stattdessen wird das Stripe-Customer-Portal verwendet.

HTTPbilling-portal-redirect.http

# 1. Portal-User klickt "Zahlungsmethode aktualisieren"
# 2. Portal ruft sellx_central:
POST /api/v2/billing/create-portal-session
Content-Type: application/json
Authorization: Bearer <session-token>

{
  "returnUrl": "https://portal.sellx.dev/dashboard/billing"
}

# 3. sellx_central erzeugt Stripe-Billing-Portal-Session
#    und liefert die Redirect-URL:
200 OK
{
  "url": "https://billing.stripe.com/p/session/xxx"
}

Der Kunde wird auf Stripe weitergeleitet, kann dort Kreditkarte austauschen / hinzufuegen, und kommt automatisch auf returnUrl zurueck. Stripe schickt im Hintergrund customer.updated + bei naechster Zahlung das aktualisierte Payment-Method-Setup.

Was passiert bei einer fehlgeschlagenen Zahlung?

1. Stripe-Zahlung schlaegt fehl (Kreditkarte abgelaufen, Limit erreicht, 3D-Secure abgebrochen). Stripe schickt invoice.payment_failed an sellx_central.
2. Status wechselt auf subscription_status = past_due → sellx_central setzt Customer-Status auf grace.
3. Kunde sieht Bannerim Portal: „Subscription beendet — bitte aktualisieren“. Plugins laufen weiter (Grace Period, 30 Tage).
4. Email-Erinnerungen Tag 1, Tag 7, Tag 14, Tag 25 (Konfiguration in Stripe-Dashboard).
5. Nach Tag 30 ohne Update: Stripe fuehrt automatische Stornierung durch, Status wechselt auf suspended.

Haeufige Probleme

FAQ

Welche Zahlungsmethoden akzeptiert sellx?

Phase 2: Kreditkarte (Visa, Mastercard, AmEx) via Stripe-Checkout. SEPA ueber Mollie folgt in Phase 3.

Wie aendere ich meine Kreditkarte?

Ueber den Button Zahlungsmethode aktualisieren im Portal leitet sellx Sie sicher zum Stripe-Billing-Portal weiter.

Was passiert, wenn meine Kreditkarte abgelehnt wird?

Stripe schickt invoice.payment_failed, sellx wechselt in Grace Period (30 Tage). Plugins laufen weiter, automatische Erinnerungen an Tag 1/7/14/25.

Wann kommt SEPA?

Phase 3. Mollie-Integration ist als Stub implementiert, Aktivierung sobald zwei oder mehr Pilotkunden aktiv anfragen.