Refunds & Notifications ยท Article 6.7
Status vernieuwen โ pull-gebaseerde synchronisatie wanneer de Stripe-webhook niet aankwam
Webhooks zijn niet perfect. Als een creditnota vast lijkt te zitten in `aangevraagd` terwijl Stripe de terugbetaling heeft verwerkt, klik op `Status vernieuwen` om de huidige staat rechtstreeks van Stripe op te halen. Dezelfde overgangslogica als de webhook; geen risico op dubbele bijwerkingen.
Status vernieuwen is de "controleer de banden"-knop. Als alles werkt, levert de webhook het oordeel van Stripe binnen seconden en heeft u deze knop niet nodig. Wanneer de webhook wordt vertraagd of verloren gaat (netwerkhapering op uw eindpunt, de webhook-wachtrij van Stripe overbelast, uw eindpunt retourneerde een 5xx-respons die de 3-daagse nieuwe pogingen van Stripe heeft uitgeput), laat Vernieuwen u het push-kanaal omzeilen en het antwoord direct ophalen. Het resultaat is hetzelfde als wanneer de webhook netjes was aangekomen.
Step by step
Merk een vastzittende
aangevraagdestatus op.Banner zegt "Terugbetaling in behandeling, verwacht binnen 3โ5 werkdagen" en blijft meer dan 24 uur statisch.
Klik op
Status vernieuwen.Vanuit de Terugbetaling-banner of de rij op de Creditnota-pagina.
Wacht ~2 seconden.
Server roept Stripe API aan op het verbonden account; lost de canonieke staat op.
UI wordt ter plaatse bijgewerkt.
Als Stripe geslaagd meldt โ banner schakelt naar "Terugbetaling voltooid op [datum]"; e-mail "terugbetaling voltooid" wordt verstuurd; offerte sluit indien van toepassing. Als mislukt โ banner biedt Opnieuw proberen / Handmatig als terugbetaald markeren opties. Als nog steeds in behandeling aan de kant van Stripe โ bannertekst wordt vernieuwd om de gerapporteerde staat van Stripe te weerspiegelen.
Geen verdere actie nodig als de staat is verschoven.
Alle downstream-hooks worden automatisch uitgevoerd.
Terugbetaling-banner met de knop Status vernieuwen. Na het klikken, een korte spinner, dan ofwel geen wijziging (Stripe nog steeds in behandeling) of bannerupdate naar eindstatus.
Why this works this way
Waarom een handmatige knop in plaats van een dagelijkse cron-synchronisatie? Kosten en latentie. Een cron-taak die Stripe dagelijks pollt voor elke aangevraagde creditnota voegt constante API-belasting toe aan de ratelimieten van Stripe EN introduceert tot 24 uur latentie voor een UI-update. De handmatige knop plaatst de kosten waar ze eigenlijk nodig zijn (de freelancer vraagt zich af waarom de banner vastzit) en geeft bijna-directe oplossing. We kunnen een geautomatiseerde synchronisatie toevoegen als ondersteuningstickets aantonen dat het waardevol zou zijn, maar het handmatige pad dekt ~95% van de gevallen.
Troubleshooting
Keep reading
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.
Refunds & Notifications
Failed refunds & recovery โ common Stripe failure reasons
A `failed` credit note has a `refund_failure_reason` string from Stripe. Most reasons fall into a small set; here's what each means and the recommended recovery.
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.