Skip to main content
Gratis starten

Proposals & Invoices · Article 5.6

Online betaling via Stripe Connect — Direct Charges, kosten, 3DS, terugbetalingen

Wanneer u Stripe verbindt, kunnen uw klanten facturen per kaart betalen op een door Clozo gehoste pagina. Afschrijvingen gaan rechtstreeks naar uw Stripe-account (Direct Charge-architectuur); Clozo neemt geen platformkosten op betalingen. De standaard verwerkingskosten van Stripe zijn van toepassing.

Stripe Connect is de architectuur waarmee Clozo kaartbetalingen kan aanbieden zonder uw geld ooit vast te houden. Zodra u de Stripe-onboardingstroom heeft voltooid op /settings/payments, heeft uw bedrijf een eigen Stripe-account; betalingen die uw klanten doen, stromen naar dat account, en Stripe betaalt uit naar uw bank op uw normale Stripe-uitbetalingsschema (doorgaans T+2 tot T+7 afhankelijk van uw land en risicoprofiel). Clozo levert alleen het checkoutoppervlak en het audittraject.

Step by step

  1. Verbind Stripe.

    Open /settings/payments en klik op Verbinden met Stripe. U wordt omgeleid naar de door Stripe gehoste onboardingstroom. Breng een ID-document en uw zakelijke IBAN mee.

  2. Wacht op charges_enabled.

    Wanneer Stripe de webhook account.updated met charges_enabled=true stuurt, registreert Clozo het (apps/webhooks/views.py:548). Uw pagina /settings/payments wisselt naar een groene banner "Stripe verbonden — betalingen accepteren".

  3. Inschakelen op een offerte.

    Wanneer u een offerte aanmaakt, staat de schakelaar online_payment_enabled standaard aan. Als u alleen SEPA wilt (geen kaart), schakel die uit in de wizard.

  4. Verstuur de offerte.

    De aanbetalingsfactuur-e-mail na ondertekening bevat nu een prominente knop "Betaal nu €X" naast de SEPA QR-code — beide opties worden gepresenteerd; de klant kiest.

  5. Klant betaalt.

    Stripe verwerkt de checkout, 3DS-verificatie indien vereist, en informeert Clozo via webhook (payment_intent.succeeded). Status wisselt naar Aanbetaling betaald doorgaans binnen 2 seconden na de successpagina van de klant.

in /settings/payments, een badge "Stripe verbonden" met statusindicatoren voor charges_enabled en payouts_enabled. Op elke offerte met online betaling ingeschakeld bevatten de menu's Documenten en Acties betalingsstatusaanwijzingen. Wanneer een betaling binnenkomt, krijgt de offerte-tijdlijn een gebeurtenis "Betaling ontvangen via Stripe — €X — pi_*****" met het PaymentIntent-ID gekoppeld aan uw Stripe-dashboard.

Why this works this way

Direct Charge-architectuur uitgelegd. Stripe Connect ondersteunt drie patronen: Direct Charges, Destination Charges en Separate Charges and Transfers. Clozo gebruikt Direct Charges [D-012], geïmplementeerd in apps/public/views.py — zie de opmerking "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}, ) ``

De parameter stripe_account is de verbonden-account-ID van de freelancer. Stripe maakt de PaymentIntent aan op dat account, niet op het platformaccount van Clozo. Geld loopt nooit via de boeken van Clozo. Dit heeft drie belangrijke gevolgen:

1. Clozo int geen platformkosten op uw betalingen. Er is geen application_fee_amount op de PaymentIntent (te verifiëren in apps/public/views.py). De inkomsten van Clozo komen uit uw abonnement, niet uit uw transacties. 2. De verwerkingskosten van Stripe zijn van toepassing op het verbonden account, niet op Clozo. U ziet ze op uw Stripe-dashboard. Typische EU-tarieven: ~1,5% + €0,25 voor EEA-kaarten, ~2,5% + €0,25 voor niet-EEA. Exacte tarieven zijn afhankelijk van uw land en Stripe-prijsniveau. 3. Terugbetalingen en geschillen horen bij uw verbonden account. Wanneer een klant een terugbetaling vraagt, wordt de terugbetaling geïnitieerd op uw account; de fondsen worden van uw saldo afgeschreven. Clozo houdt het geld nooit vast voor terugbetaling. Zie artikel 8.2 voor de terugbetalingsstroom.

3D Secure 2 (PSD2 SCA). EU-recht (PSD2 + Technische Regelgevingsnormen SCA) vereist Sterke Klantauthenticatie voor de meeste consumenten-kaartbetalingen boven €30. Stripe verwerkt dit automatisch via 3DS2 (Three-D Secure versie 2): de bank van de klant kan een extra verificatie opvragen (pushbericht naar de bankapp, sms-code, biometrische verificatie). De configuratie automatic_payment_methods={'enabled': True} van Stripe schakelt u in op de geoptimaliseerde 3DS-routering van Stripe — ze vragen alleen om verificatie wanneer vereist, niet bij elke afschrijving, wat de conversie verbetert ten opzichte van de altijd-verificeren-modus.

Welke betaalmethoden worden aangeboden. Met automatic_payment_methods ingeschakeld selecteert Stripe automatisch de beste methoden voor het land en bedrag van de klant: kaarten (Visa, Mastercard, Amex), en waar van toepassing, SEPA Incasso, iDEAL (NL), Bancontact (BE), Giropay (DE), EPS (AT), Przelewy24 (PL) en anderen. De methoden die u ziet op uw Stripe-dashboard zijn een subset hiervan; u kunt specifieke methoden uitschakelen in uw Stripe-accountinstellingen.

Onboardingvereisten. Stripe voert KYC/KYB uit bij onboarding op grond van EU AMLD5: bedrijfsnaam + adres, ID-document (paspoort of nationale ID), bewijs van bankrekening (IBAN), verklaring van uiteindelijk begunstigde. Totdat charges_enabled=true wisselt op uw account, kunt u geen kaartbetalingen accepteren — de Clozo-offerte-e-mail gaat nog steeds uit, maar de knop "Betalen met kaart" is verborgen en alleen SEPA + EPC QR blijven zichtbaar. Onboarding duurt gewoonlijk 5–10 minuten; voor sommige bedrijven vraagt Stripe aanvullende documenten op en kan het een paar werkdagen duren.

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 betaling via Stripe Connect — Direct Charges, kosten, 3DS, terugbetalingen · Help · Clozo