Proposals & Invoices · Article 5.6
Pago en línea a través de Stripe Connect — Cargos Directos, comisiones, 3DS, reembolsos
Cuando conecta Stripe, sus clientes pueden pagar facturas con tarjeta en una página alojada por Clozo. Los cargos van directamente a su cuenta de Stripe (arquitectura de Cargo Directo); Clozo no cobra ninguna comisión de plataforma sobre los pagos. Se aplican las tarifas de procesamiento estándar de Stripe.
Stripe Connect es la arquitectura que permite a Clozo ofrecer pagos con tarjeta sin retener nunca su dinero. Una vez que completa el flujo de incorporación de Stripe en /settings/payments, su empresa tiene su propia cuenta de Stripe; los pagos que realizan sus clientes fluyen a esa cuenta, y Stripe le paga a su banco según su calendario normal de pagos de Stripe (normalmente T+2 a T+7 según su país y perfil de riesgo). Clozo solo proporciona la superficie de pago y el registro de auditoría.
Step by step
Conecte Stripe.
Abra
/settings/paymentsy haga clic enConectar con Stripe. Será redirigido al flujo de incorporación alojado de Stripe. Tenga a mano un documento de identidad y su IBAN empresarial.Espere a que
charges_enabledse active.Cuando Stripe envíe el webhook
account.updatedconcharges_enabled=true, Clozo lo registra (apps/webhooks/views.py:548). Su página/settings/paymentscambia a un banner verde «Stripe conectado — aceptando pagos».Actívelo en una propuesta.
Cuando crea una propuesta, el interruptor
online_payment_enabledestá activado de forma predeterminada. Si quiere solo SEPA (sin tarjeta), desactívelo en el asistente.Envíe la propuesta.
El correo de la factura de anticipo tras la firma ahora incluye un botón destacado «Pagar €X ahora» junto al código QR SEPA — se presentan ambas opciones; el cliente elige.
El cliente paga.
Stripe gestiona el pago, el desafío 3DS si es necesario, y notifica a Clozo mediante webhook (
payment_intent.succeeded). El estado cambia aAnticipo pagadonormalmente en 2 segundos tras la página de éxito del cliente.
en /settings/payments, un distintivo «Stripe conectado» con los indicadores de estado charges_enabled y payouts_enabled. En cualquier propuesta con pago en línea activado, los menús de Documentos y Acciones incluyen indicadores del estado del pago. Cuando llega un pago, la Línea de tiempo de la propuesta obtiene un evento «Pago recibido mediante Stripe — €X — pi_*****» con el ID del PaymentIntent enlazado a su panel de Stripe.
Why this works this way
Arquitectura de Cargo Directo explicada. Stripe Connect admite tres patrones: Cargos Directos, Cargos de Destino y Cargos y Transferencias Separados. Clozo utiliza Cargos Directos [D-012], implementado en apps/public/views.py — vea el comentario «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},
)
``
El parámetro stripe_account es el ID de la cuenta conectada del autónomo. Stripe crea el PaymentIntent en esa cuenta, no en la cuenta de plataforma de Clozo. El dinero nunca pasa por los libros de Clozo. Esto tiene tres consecuencias importantes:
1. Clozo no cobra ninguna comisión de plataforma sobre sus pagos. No hay application_fee_amount en el PaymentIntent (verifíquelo en apps/public/views.py). Los ingresos de Clozo provienen de su suscripción, no de sus transacciones.
2. Las comisiones de procesamiento de Stripe se aplican a la cuenta conectada, no a Clozo. Las verá en su panel de Stripe. Tarifas típicas en la UE: ~1,5% + €0,25 para tarjetas del EEE, ~2,5% + €0,25 para las no EEE. Las tarifas exactas dependen de su país y nivel de precios de Stripe.
3. Los reembolsos y las disputas pertenecen a su cuenta conectada. Cuando un cliente solicita un reembolso, el reembolso se inicia en su cuenta; los fondos se cargan en su saldo. Clozo nunca retiene el dinero para reembolsar. Consulte el artículo 8.2 para el flujo de reembolso.
3D Secure 2 (PSD2 SCA). La ley de la UE (PSD2 + Normas Técnicas Regulatorias de SCA) requiere Autenticación Reforzada del Cliente en la mayoría de los pagos con tarjeta de consumidor superiores a €30. Stripe gestiona esto automáticamente a través de 3DS2 (Three-D Secure versión 2): el banco del cliente puede emitir un desafío de paso adicional (notificación push a la app bancaria, código SMS, solicitud biométrica). La configuración automatic_payment_methods={'enabled': True} de Stripe le incluye en el enrutamiento 3DS optimizado de Stripe — solo desafían cuando es necesario, no en cada cargo, lo que mejora la conversión frente al modo de desafío siempre activo.
Qué métodos de pago se ofrecen. Con automatic_payment_methods activado, Stripe selecciona automáticamente los mejores métodos para el país y el importe del cliente: tarjetas (Visa, Mastercard, Amex) y, cuando corresponda, Débito Directo SEPA, iDEAL (NL), Bancontact (BE), Giropay (DE), EPS (AT), Przelewy24 (PL) y otros. El conjunto de métodos que ve en su panel de Stripe es un subconjunto de estos; puede deshabilitar métodos específicos en la configuración de su cuenta de Stripe.
Requisitos de incorporación. Stripe realiza el KYC/KYB en la incorporación según la AMLD5 de la UE: nombre y dirección de la empresa, documento de identidad (pasaporte o DNI/NIE), justificante de cuenta bancaria (IBAN), declaración del titular real. Hasta que charges_enabled=true se active en su cuenta, no puede aceptar pagos con tarjeta — el correo de propuesta de Clozo sigue saliendo, pero el botón «Pagar con tarjeta» está oculto y solo SEPA + QR EPC permanecen visibles. La incorporación suele completarse en 5–10 minutos; para algunas empresas Stripe solicita documentos adicionales y puede tardar algunos días hábiles.
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.