Start trialu generuje faktury na nulu

import { Aside } from ‘@astrojs/starlight/components’;

Rozlišuj `billing_reason` a `amount_paid`. **Trial start ≠ platba** — fakturu vystav až u reálného stržení (`subscription_cycle`).

Symptom

V systému se objevují faktury na 0 Kč u nových předplatných.

Root cause

Brána posílá invoice.paid i pro billing_reason: subscription_create (start trialu) s amount_paid: 0. Webhook na to bezpodmínečně vystavoval reálnou fakturu.

Fix

Ve webhooku přeskoč nulové/zakládací události:

if (invoice.amount_paid === 0 || invoice.billing_reason === 'subscription_create') return;

Jak se tomu vyvarovat v jiných systémech

• Detection: seznam všech billing_reason hodnot, na které webhook reaguje.
• Anti-pattern: „přišel paid event → vystav fakturu” bez rozlišení důvodu.
• Lepší přístup: explicitní whitelist událostí, které znamenají reálné stržení.

Sister bugs / související

• Přesun cesty k subscription po bumpu API.