Jak přidat předplatné přes Stripe: tarify, zkušební období, webhooky a neúspěšné platby

Pro přidání předplatného přes Stripe vytvořte ve Stripe Dashboardu produkt s opakovanou cenou, pošlete zákazníky ze serveru na Stripe Checkout v režimu předplatného a nechte webhook informovat vaši aplikaci, kdy každá platba proběhne, selže, změní se nebo skončí. Stav předplatného uložte u uživatele a přístup podle něj udělujte, ne podle stránky po úspěšné platbě. Přidejte tlačítko Spravovat fakturaci, které otevře hostovaný zákaznický portál Stripe, kde lidé mohou změnit kartu, přepnout tarif nebo zrušit předplatné, aniž byste tyto obrazovky museli stavět sami.

Tento průvodce navazuje na jak přidat platby do aplikace, který popisuje jednorázový Checkout, testovací režim a spuštění naostro. Zde se zaměřujeme na to, v čem se opakované platby liší. Údaje o Stripe jsou z jeho dokumentace k září 2026.

Proč jsou předplatné těžší než jednorázové platby

Jednorázová platba proběhne, zatímco je zákazník ve vaší aplikaci. Předplatné běží dál i poté, co odejde: měsíční obnovení, karty, které vyprší, upgrady uprostřed období, zrušení, která se projeví ke konci období. Vaše aplikace se o tom dozví jen přes webhooky. Většina chyb u předplatného vzniká tím, že se první platba bere jako celý příběh.

Vaše možnosti

Pro většinu aplikací je Checkout plus portál správný kompromis. Pokud vás zajímá daň, porovnejte poskytovatele v Stripe vs Paddle vs Lemon Squeezy.

Nejdřív naplánujte ceny ve Stripe

Ve Stripe je produkt to, co prodáváte („Pro tarif“), a cena je to, jak to účtujete („600 Kč měsíčně“, „6 000 Kč ročně“). Jeden produkt může mít několik cen. Rozhodněte:

• Které tarify nabízíte a co každý odemyká ve vaší aplikaci
• Měsíční, roční, nebo obojí
• Zda nabízíte zkušební období a zda vyžaduje kartu předem

Produkty a ceny vytvořte v testovacím režimu a uložte si jejich ID cen; vaše aplikace na ně odkazuje. Pokud ceny ještě nemáte vyladěné, přečtěte si jak nastavit cenu SaaS produktu a freemium vs zkušební verze.

Životní cyklus předplatného, který musíte zvládnout

Dokumentace Stripe k předplatnému uvádí stavy, ve kterých může být. Pro přístup jsou nejdůležitější tyto:

Uložte stav na záznam uživatele nebo účtu a přístup zakládejte na něm. Aktualizujte ho pokaždé, když přijde relevantní webhook.

Události webhooků, které musíte obsloužit

Pravidla pro obsluhu z webhookové dokumentace Stripe stále platí: ověřujte podpis pomocí surového těla požadavku, rychle vracejte kód 2xx, zvládejte duplicitní a nepořadové události a počítejte s opakováním. Princip webhooku vysvětluje průvodce co je webhook a pravidla podrobně popisuje průvodce platbami.

Krok za krokem

1. Vytvořte produkty a ceny v testovacím režimu Stripe.
2. Přidejte tajné údaje: tajný klíč, ID cen a později podepisovací tajemství webhooku. Nikdy je nedávejte do kódu na frontendu.
3. Stránka s cenami: tlačítko každého tarifu volá váš server, který vytvoří Checkout Session v režimu předplatného pro přihlášeného uživatele. Předejte ID svého uživatele, aby webhook mohl platbu spárovat s účtem.
4. Koncový bod webhooku: ověřte podpisy, obsluhujte události výše a aktualizujte jeden záznam předplatného na uživatele.
5. Omezte funkce podle uloženého stavu a tarifu, kontrolovaného na serveru u každé chráněné akce, ne jen podle skrytých tlačítek.
6. Zákaznický portál: nastavte ho v Stripe Dashboardu (na které tarify lze přejít a zda lze zrušit), potom přidejte tlačítko Spravovat fakturaci, které na serveru vytvoří relaci portálu a přesměruje na něj.
7. Neúspěšné platby: v nastavení fakturace Stripe zvolte chování při opakování a co se stane po posledním pokusu. Zobrazujte v aplikaci upozornění, když je stav past_due.
8. Otestujte celý životní cyklus, pak publikujte a zaregistrujte ostrý webhook.

Prompty pro váš nástroj s AI

Přidej fakturaci předplatného přes Stripe. Tarify: Starter (ID ceny v STRIPE_PRICE_STARTER) a Pro (STRIPE_PRICE_PRO). Stránka s cenami vytváří na serveru Checkout Session v režimu předplatného pomocí STRIPE_SECRET_KEY a přidává ID přihlášeného uživatele. Ulož na uživatele ID zákazníka Stripe, ID předplatného, tarif a stav. Tajný klíč nikdy neposílej do prohlížeče.

Přidej POST /api/stripe/webhook. Ověř podpis pomocí STRIPE_WEBHOOK_SECRET nad surovým tělem požadavku. Obsluhuj checkout.session.completed, invoice.paid, invoice.payment_failed, customer.subscription.updated, customer.subscription.deleted a customer.subscription.trial_will_end. Zaznamenávej ID zpracovaných událostí, aby se duplicity ignorovaly. Stav uživatele aktualizuj z objektu předplatného, ne podle pořadí, v jakém události přijdou.

Omez funkce Pro na serveru: povol je jen tehdy, když je stav active nebo trialing a tarif je Pro. Když je stav past_due, zobraz upozornění „Platba selhala, aktualizujte kartu“. Přidej tlačítko Spravovat fakturaci, které otevře zákaznický portál Stripe pro tohoto uživatele.

Upgrady, downgrady a proporcionální vyúčtování

Když zákazník přepne tarif, dokumentace Stripe uvádí, že změna často vytvoří proration (proporcionální vyúčtování): nová cena se uplatní na zbytek aktuálního fakturačního období. Proration si můžete zobrazit nebo je vypnout. Pokud mají tarify stejný interval, data účtování zůstanou stejná; přechod z měsíčního na roční posune datum účtování na den přepnutí. Nechat zákazníky měnit tarif v portálu vám ušetří psaní této logiky, ale v nastavení portálu rozhodněte, které přechody jsou povolené.

Kontrolní seznam testů

Použijte testovací režim Stripe a testovací karty a projděte každý stav:

• Nové předplatné udělí správný tarif správnému uživateli
• Zavření karty hned po platbě stále udělí přístup (dokazuje, že webhook funguje)
• Zamítnutá karta při registraci nic neudělí
• Neúspěšné obnovení přepne účet do stavu past_due a zobrazí upozornění
• Aktualizace karty v portálu obnoví aktivní stav
• Upgrade a downgrade správně změní funkce
• Zrušení ke konci období ponechá přístup do konce období, pak ho odebere
• Uživatelé ve zkušebním období mají přístup, dostanou připomínku a správně přejdou na placený tarif nebo přístup ztratí
• Odeslání stejné události webhooku dvakrát nic nezmění

Testovací hodiny Stripe umožňují simulovat plynutí času, takže můžete testovat obnovení bez čekání měsíc. Jak je používat, zjistěte v aktuální dokumentaci Stripe k testování.

Časté chyby

• Udělování přístupu na stránce po úspěchu. Zákazníci mohou zaplatit a na stránku se nikdy nedostat. Použijte webhook.
• Obsluha jen první platby. Obnovení, selhání a zrušení přicházejí později jako události.
• Kontrola stavu tarifu jen ve frontendu. Kdokoli může volat vaše API přímo.
• Náhodně víc předplatných na jednoho uživatele. Před vytvořením nové Checkout Session zkontrolujte existující předplatné, nebo pošlete stávající zákazníky do portálu.
• Odebrání přístupu hned při prvním neúspěšném obnovení. Karty selhávají z nudných důvodů. Krátká doba na vyrovnání s jasným upozorněním zákazníky udrží.
• Zapomenutý ostrý webhook. Testovací a ostrý koncový bod mají různá podepisovací tajemství.
• Ignorování daně a vratek. Rozhodněte o zásadách vracení peněz a daňových povinnostech se účetní ještě před spuštěním.

Předplatné v Mythexu

Aplikace, které stavíte na Mythexu, používají váš vlastní účet a klíče Stripe; pro vaši aplikaci neexistuje připojení Stripe jedním kliknutím. Přidejte své testovací klíče a ID cen jako tajné údaje projektu, používejte prompty podobné výše uvedeným a testujte testovacími kartami Stripe v Preview. Webhooky potřebují veřejnou adresu vaší aplikace, takže publikujte dřív, než koncový bod zaregistrujete ve Stripe, a po přepnutí na ostré klíče publikujte znovu, aby je ostrá aplikace převzala. Viz Přijímání plateb přes Stripe a Obsluha webhooků v backendu. Pro širší pohled na produkt, jak postavit MVP SaaS popisuje, co stavět kolem fakturace.

Otázky