Skip to main content
Kostenlos starten

Proposals & Invoices · Article 5.6

Online-Zahlung über Stripe Connect – Direct Charges, Gebühren, 3DS, Erstattungen

Wenn Sie Stripe verbinden, können Ihre Kunden Rechnungen per Karte auf einer von Clozo gehosteten Seite bezahlen. Belastungen gehen direkt auf Ihr Stripe-Konto (Direct-Charge-Architektur); Clozo erhebt keine Plattformgebühr auf Zahlungen. Stripes Standard-Transaktionsgebühren gelten.

Stripe Connect ist die Architektur, die Clozo ermöglicht, Kartenzahlungen anzubieten, ohne Ihr Geld jemals zu halten. Sobald Sie den Stripe-Onboarding-Ablauf unter /settings/payments abgeschlossen haben, verfügt Ihr Unternehmen über ein eigenes Stripe-Konto; Zahlungen Ihrer Kunden fließen in dieses Konto, und Stripe zahlt gemäß Ihrem normalen Stripe-Auszahlungsplan an Ihre Bank aus (typischerweise T+2 bis T+7, je nach Land und Risikoprofil). Clozo stellt lediglich die Checkout-Oberfläche und den Prüfpfad bereit.

Step by step

  1. Stripe verbinden.

    Unter /settings/payments öffnen und auf Mit Stripe verbinden klicken. Sie werden zu Stripes gehostetem Onboarding-Ablauf weitergeleitet. Ausweisdokument und Unternehmens-IBAN bereithalten.

  2. Auf charges_enabled warten.

    Wenn Stripe den Webhook account.updated mit charges_enabled=true sendet, speichert Clozo das (apps/webhooks/views.py:548). Ihre Seite /settings/payments zeigt ein grünes Banner „Stripe verbunden – Zahlungen werden angenommen".

  3. In einem Angebot aktivieren.

    Wenn Sie ein Angebot erstellen, ist der Schalter online_payment_enabled standardmäßig aktiviert. Wenn Sie nur SEPA (keine Karte) möchten, deaktivieren Sie ihn im Assistenten.

  4. Angebot senden.

    Die Anzahlungsrechnungs-E-Mail nach der Unterzeichnung enthält jetzt eine auffällige Schaltfläche „Jetzt €X bezahlen" neben dem SEPA-QR-Code – beide Optionen werden angezeigt; der Kunde wählt.

  5. Kunde bezahlt.

    Stripe übernimmt den Checkout, die 3DS-Prüfung falls erforderlich, und benachrichtigt Clozo per Webhook (payment_intent.succeeded). Der Status wechselt typischerweise innerhalb von 2 Sekunden nach der Erfolgsseite des Kunden zu Anzahlung bezahlt.

In /settings/payments ein „Stripe verbunden"-Abzeichen mit Status-Indikatoren für charges_enabled und payouts_enabled. Bei jedem Angebot mit aktivierter Online-Zahlung enthalten die Dokumente- und Aktionsmenüs Zahlungsstatus-Hinweise. Wenn eine Zahlung eingeht, erhält die Angebots-Timeline ein Ereignis „Zahlung via Stripe eingegangen – €X – pi_*****" mit der PaymentIntent-ID, die zu Ihrem Stripe-Dashboard verlinkt.

Why this works this way

Die Direct-Charge-Architektur erklärt. Stripe Connect unterstützt drei Muster: Direct Charges, Destination Charges und Separate Charges and Transfers. Clozo verwendet Direct Charges [D-012], implementiert in apps/public/views.py – siehe den Kommentar "A-005: Direct Charge — money goes to freelancer's connected account":

``python payment_intent = stripe.PaymentIntent.create( amount=int(amount_cents), currency=currency.lower(), stripe_account=proposal.user.stripe_account.account_id, # ← Direct Charge metadata={...}, automatic_payment_methods={'enabled': True}, ) ``

Der Parameter stripe_account ist die ID des verbundenen Kontos des Freiberuflers. Stripe erstellt die PaymentIntent auf diesem Konto, nicht auf Clozos Plattformkonto. Geld fließt niemals durch Clozos Bücher. Das hat drei wichtige Konsequenzen:

1. Clozo erhebt keine Plattformgebühr auf Ihre Zahlungen. Es gibt kein application_fee_amount auf der PaymentIntent (prüfbar in apps/public/views.py). Clozos Einnahmen stammen aus Ihrem Abonnement, nicht aus Ihren Transaktionen. 2. Stripes Transaktionsgebühren gelten für das verbundene Konto, nicht für Clozo. Sie sehen sie in Ihrem Stripe-Dashboard. Typische EU-Sätze: ca. 1,5% + €0,25 für EWR-Karten, ca. 2,5% + €0,25 für Nicht-EWR-Karten. Genaue Sätze hängen von Ihrem Land und Ihrem Stripe-Preistier ab. 3. Erstattungen und Streitfälle gehören zu Ihrem verbundenen Konto. Wenn ein Kunde eine Erstattung beantragt, wird diese auf Ihrem Konto eingeleitet; die Mittel werden Ihrem Guthaben belastet. Clozo hält nie Geld zur Erstattung. Siehe Artikel 8.2 für den Erstattungsablauf.

3D Secure 2 (PSD2 SCA). EU-Recht (PSD2 + SCA Regulatory Technical Standards) verlangt eine Starke Kundenauthentifizierung (Strong Customer Authentication) für die meisten Verbraucherkartenzahlungen über €30. Stripe handhabt das automatisch über 3DS2 (Three-D Secure Version 2): Die Bank des Kunden kann eine zusätzliche Prüfung anfordern (Push-Benachrichtigung an die Bank-App, SMS-Code, biometrische Eingabe). Stripes Konfiguration automatic_payment_methods={'enabled': True} wählt Stripes optimiertes 3DS-Routing – Herausforderungen werden nur dann gestellt, wenn erforderlich, nicht bei jeder Belastung, was die Konversionsrate gegenüber dem Immer-Herausfordern-Modus verbessert.

Welche Zahlungsmethoden angeboten werden. Mit aktiviertem automatic_payment_methods wählt Stripe automatisch die besten Methoden für das Land und den Betrag des Kunden: Karten (Visa, Mastercard, Amex) und, wo verfügbar, SEPA-Lastschrift, iDEAL (NL), Bancontact (BE), Giropay (DE), EPS (AT), Przelewy24 (PL) und andere. Die auf Ihrem Stripe-Dashboard angezeigten Methoden sind eine Teilmenge davon; Sie können bestimmte Methoden in Ihren Stripe-Kontoeinstellungen deaktivieren.

Onboarding-Anforderungen. Stripe führt bei der Registrierung eine KYC/KYB-Prüfung gemäß EU-AMLD5 durch: Unternehmensname + Adresse, Ausweisdokument (Reisepass oder Personalausweis), Kontonachweis (IBAN), Erklärung zum wirtschaftlich Berechtigten. Bis charges_enabled=true auf Ihrem Konto aktiviert ist, können Sie keine Kartenzahlungen annehmen – die Clozo-Angebots-E-Mail wird weiterhin versendet, aber die Schaltfläche „Per Karte bezahlen" ist ausgeblendet, und nur SEPA + EPC-QR sind sichtbar. Das Onboarding ist in der Regel in 5–10 Minuten abgeschlossen; für manche Unternehmen fordert Stripe zusätzliche Dokumente an, was einige Werktage dauern kann.

Troubleshooting

Keep reading

Configuration

Stripe Connect: enabling card payments end to end

Five minutes through Stripe's onboarding turns on card payments for every future proposal — no extra config, no separate Stripe dashboard to manage, payouts land in your IBAN.

Lifecycle

Status: Deposit paid — work can start

The deposit landed (Stripe webhook or manual confirmation). Clozo flips the status, queues the deposit receipt PDF, and starts a behind-the-scenes job to pre-render the final invoice. You can begin the work.

Proposals & Invoices

SEPA bank transfer with EPC QR — when offered, how it works, what to put on the invoice

Every Clozo invoice includes IBAN, BIC, and an EPC-format QR code that any modern EU banking app scans into a pre-filled SEPA transfer. Works with or without Stripe enabled.

Refunds & Notifications

Stripe automatic refund (Direct Charges via Connect)

When the original deposit was paid via Stripe, the refund is automatic. Clozo issues a Refund on the freelancer's connected account, watches for the `refund.updated` webhook, and flips the credit note to `succeeded` once Stripe confirms — typically within 3–5 business days for the cash to reach the client.

Refunds & Notifications

Refund stages: issued → requested → succeeded (or manual)

The credit note moves through up to four states from creation to settled. Each state corresponds to a specific point in the refund lifecycle, with predictable UI badges and email triggers.

Online-Zahlung über Stripe Connect – Direct Charges, Gebühren, 3DS, Erstattungen · Help · Clozo