Nastavení platební brány Stripe (Self-Hosting & Connect)

LockMyCal obsahuje integraci s platební bránou Stripe přes Stripe-hostovaný Checkout, která umožňuje účtovat platby za rezervované schůzky a automatizovat finanční toky.

1. Získání Secret Key ve Stripe Dashboardu

1. Přihlaste se do dashboard.stripe.com.
2. Ujistěte se, zda pracujete v Testovacím režimu (Test mode) nebo v Produkci (Live mode).
3. Přejděte do Developers -> API keys.
4. Zkopírujte Secret key (sk_live_... nebo sk_test_...). Platby probíhají přes Stripe-hostovanou stránku Checkout, takže appka nepotřebuje žádný Publishable key.

2. Vytvoření Stripe Webhook Endpointu

Stripe potřebuje informovat LockMyCal o úspěšně dokončených platbách, vrácených penězích a sporech:

1. Ve Stripe přejděte do Developers -> Webhooks -> Add endpoint.
2. Do pole Endpoint URL zadejte:

   https://rezervace.vasedomena.cz/webhooks/stripe

3. Vyberte události pro sledování (Events to listen to):
   • checkout.session.completed
   • checkout.session.expired
   • charge.refunded
   • charge.dispute.created
   • charge.dispute.closed
4. Po vytvoření klikněte na Reveal v sekci Signing secret a zkopírujte klíč whsec_....

3. Konfigurace proměnných prostředí

Vložte získané hodnoty do .env:

# Bez této volby jsou platby za schůzky vypnuté
MEETING_PAYMENTS_ENABLED=true

STRIPE_SECRET_KEY=sk_live_xxxxxxxxxxxxxxxxxxxxxxxx
STRIPE_WEBHOOK_SECRET=whsec_xxxxxxxxxxxxxxxxxxxxxxxx

# Volitelné
MEETING_PAYMENTS_DEFAULT_COUNTRY=CZ        # výchozí země nových Stripe účtů organizátorů
MEETING_PAYMENTS_APPLICATION_FEE_BP=0      # poplatek platformy v bazických bodech (100 = 1 %), výchozí 0

Pokud povolujete platby jednotlivým organizátorům přes Stripe Connect (viz níže), vytvořte ve Stripe druhý webhook endpoint https://rezervace.vasedomena.cz/webhooks/stripe/connect pro události připojených účtů (např. account.updated) a jeho secret nastavte samostatně:

STRIPE_CONNECT_WEBHOOK_SECRET=whsec_xxxxxxxxxxxxxxxxxxxxxxxx

4. Stripe Connect pro jednotlivé organizátory

Každý organizátor přijímá platby na svůj vlastní Stripe účet. Aplikace ho pro něj založí přes Stripe API – žádné ruční nastavování Connect Client ID není potřeba.

1. Ujistěte se, že máte nastavený STRIPE_SECRET_KEY (viz výše).
2. Organizátor v dashboardu přejde do Integrace → Platby a klikne na Připojit Stripe.
3. Zvolí zemi, ve které podniká, a LockMyCal ho přesměruje na Stripe-hostovaný onboarding (fakturační a bankovní údaje).
4. Nedokončený onboarding lze kdykoliv dokončit tlačítkem Pokračovat v nastavení.
5. Po dokončení může organizátor přijímat platby přímo na svůj Stripe účet. Pokud Stripe účet omezí, aplikace zobrazí vysvětlení a odkaz na nápravu.