Troubleshooting & Reference · Article 7.3
«El reembolso aparece como Solicitado pero Stripe dice que se completó»
La nota de crédito está bloqueada en estado «Solicitado» mientras el panel de Stripe muestra el reembolso como `succeeded`. Casi siempre es una suscripción de webhook faltante en la cuenta Connect; un clic en `Actualizar estado` lo resuelve.
Los reembolsos de Stripe Connect dependen de los webhooks para mantener la vista de Clozo sincronizada con el estado real de Stripe. Cuando una suscripción de webhook está mal configurada o falla de forma transitoria, el reembolso «se completa» en el lado de Stripe pero Clozo no lo sabe todavía. El botón Actualizar estado es la reconciliación manual — es seguro hacer clic tantas veces como se quiera.
Step by step
Confirme el estado en Stripe.
Abra el panel de Stripe → Reembolsos → busque el ID del reembolso. Si el estado es
succeeded, continúe.Haga clic en
Actualizar estadoen la nota de crédito en Clozo (página de Notas de crédito o el detalle de la propuesta).
Observe el cambio de estado.
En 2-3 segundos, la nota de crédito debería pasar a
Completadoy el correo de reembolso completado se envía.
Why this works this way
Los reembolsos pasan por cuatro estados: Solicitado → Procesando → Completado (o Fallido). La máquina de estados avanza cuando llega el webhook correspondiente de Stripe — refund.created, refund.updated, charge.refunded. Si falta alguna suscripción en el panel de la cuenta Connect, la transición de estado correspondiente se bloquea.
En mayo de 2026 ([D-115] / BUG-PROD-009), identificamos que algunas cuentas Connect creadas antes de la corrección no tenían refund.updated en su conjunto de suscripciones. La corrección se aplicó en dos partes: (1) la plantilla de suscripción predeterminada ahora incluye refund.updated para todas las cuentas nuevas, (2) una migración rellenó las suscripciones de las cuentas existentes. Si se incorporó antes de mayo de 2026 y no ha aplicado la corrección, el botón Actualizar estado cubre la brecha.
Actualizar estado llama a la API de Stripe (stripe.Refund.retrieve(refund_id)) y aplica el estado devuelto directamente. No hay riesgo de procesamiento doble — la máquina de estados local es idempotente en el mismo estado objetivo.
Troubleshooting
Keep reading
Refunds & Notifications
Email: "Refund completed — €X returned"
The closing email of a refund flow. Fires when Stripe confirms the refund succeeded (or when you mark a SEPA refund as complete). Carries the credit note PDF.
Refunds & Notifications
The Credit Notes page
A first-class section in the freelancer dashboard that lists every credit note across all your proposals, with status, refund amount, linked proposal, and action buttons. Use this when you want to manage refunds without drilling into each proposal individually.