Proposals & Invoices · Article 5.6

Płatność online przez Stripe Connect — Direct Charges, opłaty, 3DS, zwroty

Gdy połączysz Stripe, Twoi klienci mogą opłacać faktury kartą na stronie hostowanej przez Clozo. Obciążenia trafiają bezpośrednio na Twoje konto Stripe (architektura Direct Charge); Clozo nie pobiera opłaty platformowej od płatności. Obowiązują standardowe opłaty za przetwarzanie Stripe.

Stripe Connect to architektura, która pozwala Clozo oferować płatności kartą bez trzymania Twoich pieniędzy. Po zakończeniu przepływu onboardingu Stripe pod /settings/payments, Twoja firma ma własne konto Stripe; płatności od klientów trafiają na to konto, a Stripe wypłaca do Twojego banku zgodnie z Twoim normalnym harmonogramem wypłat Stripe (zazwyczaj T+2 do T+7 w zależności od kraju i profilu ryzyka). Clozo tylko zapewnia powierzchnię kasową i ścieżkę audytu.

Step by step

Połącz Stripe.
Otwórz /settings/payments i kliknij Połącz ze Stripe. Zostaniesz przekierowany do hostowanego przepływu onboardingu Stripe. Miej przy sobie dokument tożsamości i IBAN swojej firmy.
Poczekaj na charges_enabled.
Gdy Stripe wyśle webhook account.updated z charges_enabled=true, Clozo rejestruje to (apps/webhooks/views.py:548). Twoja strona /settings/payments przełącza się na zielony baner „Stripe połączony — przyjmowanie płatności".
Włącz dla oferty.
Gdy tworzysz ofertę, przełącznik online_payment_enabled jest domyślnie włączony. Jeśli chcesz tylko SEPA (bez karty), wyłącz go w kreatorze.
Wyślij ofertę.
E-mail faktury zaliczkowej po podpisaniu zawiera teraz wyraźny przycisk „Zapłać X EUR teraz" obok kodu QR SEPA — obie opcje są prezentowane; klient wybiera.
Klient płaci.
Stripe obsługuje kasę, wyzwanie 3DS jeśli wymagane, i powiadamia Clozo przez webhook (payment_intent.succeeded). Status zmienia się na Zaliczka opłacona zazwyczaj w ciągu 2 sekund od strony sukcesu klienta.

w /settings/payments, odznaka „Stripe połączony" z wskaźnikami statusu charges_enabled i payouts_enabled. Na każdej ofercie z włączoną płatnością online, menu Dokumenty i Akcje zawierają informacje o statusie płatności. Gdy płatność wpłynie, Oś Czasu oferty dostaje zdarzenie „Płatność otrzymana przez Stripe — X EUR — pi_*****" z identyfikatorem PaymentIntent linkującym do Twojego panelu Stripe.

Why this works this way

Architektura Direct Charge wyjaśniona. Stripe Connect obsługuje trzy wzorce: Direct Charges, Destination Charges i Separate Charges and Transfers. Clozo używa Direct Charges [D-012], zaimplementowanych w apps/public/views.py — patrz komentarz „A-005: Direct Charge — pieniądze trafiają na połączone konto freelancera":

``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}, )``

Parametr stripe_account to identyfikator połączonego konta freelancera. Stripe tworzy PaymentIntent na tym koncie, nie na koncie platformy Clozo. Pieniądze nigdy nie przechodzą przez księgi Clozo. Ma to trzy ważne konsekwencje:

1. Clozo nie pobiera opłaty platformowej od Twoich płatności. Nie ma application_fee_amount na PaymentIntent (sprawdź w apps/public/views.py). Przychody Clozo pochodzą z Twojej subskrypcji, nie z Twoich transakcji. 2. Opłaty za przetwarzanie Stripe dotyczą połączonego konta, nie Clozo. Widzisz je na swoim panelu Stripe. Typowe stawki UE: ~1,5% + 0,25 EUR dla kart EOG, ~2,5% + 0,25 EUR dla kart spoza EOG. Dokładne stawki zależą od kraju i poziomu cenowego Stripe. 3. Zwroty i spory należą do Twojego połączonego konta. Gdy klient prosi o zwrot, zwrot jest inicjowany na Twoim koncie; środki obciążają Twoje saldo. Clozo nigdy nie trzyma pieniędzy do zwrotu. Patrz artykuł 8.2 dla przepływu zwrotu.

3D Secure 2 (PSD2 SCA). Prawo UE (PSD2 + SCA Regulatory Technical Standards) wymaga Silnego Uwierzytelniania Klienta przy większości konsumenckich płatności kartą powyżej 30 EUR. Stripe obsługuje to automatycznie przez 3DS2 (Three-D Secure wersja 2): bank klienta może wydać wyzwanie step-up (powiadomienie push do aplikacji bankowej, kod SMS, biometryczne). Konfiguracja automatic_payment_methods={'enabled': True} w Stripe optuje w zoptymalizowany routing 3DS Stripe — wyzwanie tylko gdy wymagane, nie przy każdej opłacie, co poprawia konwersję vs tryb zawsze-wyzwanie.

Jakie metody płatności są oferowane. Z włączonymi automatic_payment_methods, Stripe automatycznie wybiera najlepsze metody dla kraju i kwoty klienta: karty (Visa, Mastercard, Amex) i tam gdzie kwalifikuje, SEPA Direct Debit, iDEAL (NL), Bancontact (BE), Giropay (DE), EPS (AT), Przelewy24 (PL) i inne. Zestaw metod widoczny na Twoim panelu Stripe to podzbiór tych; możesz wyłączyć określone metody w ustawieniach konta Stripe.

Wymagania onboardingu. Stripe przeprowadza KYC/KYB przy onboardingu zgodnie z EU AMLD5: nazwa firmy + adres, dokument tożsamości (paszport lub dowód osobisty), dowód konta bankowego (IBAN), deklaracja rzeczywistego właściciela. Do czasu gdy flaga charges_enabled=true nie przełączy się na Twoim koncie, nie możesz przyjmować płatności kartą — e-mail oferty Clozo nadal wychodzi, ale przycisk „Zapłać kartą" jest ukryty i widoczne pozostają tylko SEPA + kod QR EPC. Onboarding zazwyczaj kończy się w 5–10 minut; dla niektórych firm Stripe prosi o dodatkowe dokumenty i może to zająć kilka dni roboczych.

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.