Ako pridať predplatné cez Stripe: plány, skúšky, webhooky a neúspešné platby

Na pridanie predplatného cez Stripe vytvorte v Stripe Dashboarde produkt s opakovanou cenou, z vášho servera pošlite zákazníkov na Stripe Checkout v režime predplatného a nechajte webhook povedať vašej aplikácii, kedy každá platba prebehne, zlyhá, zmení sa alebo skončí. Stav predplatného ukladajte pri používateľovi a prístup odvodzujte z neho, nie zo stránky úspechu. Pridajte tlačidlo Spravovať fakturáciu, ktoré otvorí hostovaný zákaznícky portál Stripe, aby ľudia mohli meniť karty, prepínať plány a rušiť predplatné bez toho, aby ste tieto obrazovky budovali sami.

Tento návod nadväzuje na ako pridať platby do aplikácie, ktorý pokrýva jednorazový Checkout, testovací režim a spustenie ostrej prevádzky. Tu sa zameriavame na to, čo sa pri opakovanej fakturácii líši. Údaje o Stripe sú z dokumentácie Stripe k septembru 2026.

Prečo sú predplatné náročnejšie než jednorazové platby

Jednorazová platba sa odohrá, kým je zákazník vo vašej aplikácii. Predplatné pokračuje aj potom, čo odíde: mesačné obnovenia, karty, ktorým vyprší platnosť, upgrady uprostred cyklu, zrušenia, ktoré nadobudnú účinnosť na konci obdobia. Vaša aplikácia sa o tom dozvie len cez webhooky. Väčšina chýb v predplatnom vzniká tým, že sa prvá platba považuje za celý príbeh.

Vaše možnosti

Pre väčšinu aplikácií je Checkout plus portál správny kompromis. Ak vás znepokojuje spracovanie dane, porovnajte poskytovateľov v článku Stripe vs Paddle vs Lemon Squeezy.

Najprv naplánujte ceny v Stripe

V Stripe je produkt to, čo predávate („Pro plán“), a cena je to, ako za neho účtujete („20 $ mesačne“, „200 $ ročne“). Jeden produkt môže mať niekoľko cien. Rozhodnite:

• Aké úrovne ponúkate a čo každá odomkne vo vašej aplikácii
• Mesačne, ročne alebo obidve možnosti
• Či ponúkate skúšobné obdobie a či vyžaduje kartu vopred

Vytvorte produkty a ceny v testovacom režime a uchovajte ich ID cien; vaša aplikácia na ne odkazuje. Ak ceny ešte nemáte ustálené, prečítajte si ako nastaviť cenu SaaS produktu a freemium vs bezplatná skúšobná verzia.

Životný cyklus predplatného, ktorý musíte spracovať

Prehľad predplatných v Stripe uvádza stavy, ktoré predplatné môže mať. Tie, ktoré sú pre prístup najdôležitejšie:

Stav ukladajte do záznamu používateľa alebo účtu a prístup naň založte. Pri každom príchode relevantného webhooku ho aktualizujte.

Udalosti webhooku, ktoré spracovať

Pravidlá pre spracovanie z dokumentácie Stripe k webhookom stále platia: overte podpis pomocou surového tela, rýchlo vráťte 2xx, ošetrite duplicitné a neporadené udalosti a počítajte s opakovaniami. Článok čo je webhook vysvetľuje myšlienku a návod k platbám uvádza pravidlá podrobnejšie.

Postup krok za krokom

1. Vytvorte produkty a ceny v testovacom režime Stripe.
2. Pridajte tajomstvá: tajný kľúč, ID cien a neskôr podpisové tajomstvo webhooku. Nikdy ich nedávajte do kódu frontendu.
3. Stránka s cenami: tlačidlo každého plánu volá váš server, ktorý vytvorí Checkout Session v režime predplatného pre prihláseného používateľa. Pošlite ID svojho používateľa, aby webhook mohol platbu priradiť k účtu.
4. Koncový bod webhooku: overujte podpisy a spracujte vyššie uvedené udalosti, pričom aktualizujte jeden záznam predplatného na používateľa.
5. Obmedzte funkcie podľa uloženého stavu a plánu, kontrolovaného na serveri pri každej chránenej akcii, nielen skrytými tlačidlami.
6. Zákaznícky portál: nastavte ho v Stripe Dashboarde (na ktoré plány môžu ľudia prejsť, či môžu zrušiť), potom pridajte tlačidlo Spravovať fakturáciu, ktoré na serveri vytvorí reláciu portálu a presmeruje naň.
7. Neúspešné platby: v nastaveniach fakturácie Stripe zvoľte správanie pri opakovaniach a to, čo sa stane po poslednom pokuse. Kým je stav past_due, zobrazte v aplikácii banner.
8. Otestujte celý životný cyklus, potom publikujte a zaregistrujte ostrý webhook.

Prompty pre váš AI nástroj

Pridaj fakturáciu predplatného cez Stripe. Plány: Starter (ID ceny v STRIPE_PRICE_STARTER) a Pro (STRIPE_PRICE_PRO). Stránka s cenami vytvorí na serveri Checkout Session v režime predplatného pomocou STRIPE_SECRET_KEY, s pripojeným ID prihláseného používateľa. Ulož ID zákazníka v Stripe, ID predplatného, plán a stav pri používateľovi. Tajný kľúč nikdy nevystavuj prehliadaču.

Pridaj POST /api/stripe/webhook. Over podpis pomocou STRIPE_WEBHOOK_SECRET z surového tela požiadavky. Spracuj checkout.session.completed, invoice.paid, invoice.payment_failed, customer.subscription.updated, customer.subscription.deleted a customer.subscription.trial_will_end. Zaznamenávaj spracované ID udalostí, aby sa duplicity ignorovali. Stav používateľa aktualizuj z objektu predplatného, nie podľa poradia, v akom udalosti prídu.

Obmedz funkcie Pro na serveri: povoľ ich len vtedy, keď je stav active alebo trialing a plán je Pro. Keď je stav past_due, zobraz banner „platba zlyhala, aktualizujte kartu“. Pridaj tlačidlo Spravovať fakturáciu, ktoré otvorí zákaznícky portál Stripe pre tohto používateľa.

Upgrady, downgrady a proration

Keď zákazník prepne plán, dokumentácia Stripe uvádza, že zmena často vytvorí proration: nová cena sa uplatní na zvyšok aktuálneho fakturačného obdobia. Prorácie si môžete zobraziť v náhľade alebo ich vypnúť. Ak majú plány rovnaký interval, fakturačné dátumy zostávajú rovnaké; prechod z mesačného na ročné posunie fakturačný dátum na deň prepnutia. Keď zákazníkom dovolíte meniť plány v portáli, ušetríte si písanie tejto logiky, ale v nastaveniach portálu rozhodnite, ktoré prepnutia sú povolené.

Kontrolný zoznam testovania

Používajte testovací režim Stripe a testovacie karty a prejdite každý stav:

• Nové predplatné prideli správny plán správnemu používateľovi
• Zatvorenie karty hneď po zaplatení stále prinesie prístup (dokazuje, že webhook funguje)
• Zamietnutá karta pri registrácii nedá nič
• Neúspešné obnovenie dá účet do stavu past_due a zobrazí banner
• Aktualizácia karty v portáli obnoví stav active
• Upgrade a downgrade správne menia funkcie
• Zrušenie ku koncu obdobia ponechá prístup do dátumu konca a potom ho odstráni
• Používatelia v skúšobnom období majú prístup, dostanú pripomienku a správne prejdú na platené alebo prídu o prístup
• Odoslanie tej istej udalosti webhooku dvakrát nič nezmení

Testovacie hodiny Stripe vám umožnia simulovať plynutie času, takže môžete testovať obnovenia bez čakania mesiac. Ako ich používať, pozrite si aktuálnu testovaciu dokumentáciu Stripe.

Časté chyby

• Udelenie prístupu na stránke úspechu. Zákazníci môžu zaplatiť a na ňu sa nikdy nedostať. Použite webhook.
• Spracovanie len prvej platby. Obnovenia, zlyhania a zrušenia prichádzajú neskôr ako udalosti.
• Kontrola stavu plánu len vo front ende. Ktokoľvek môže volať vaše API priamo.
• Jeden používateľ, náhodou veľa predplatných. Pred vytvorením novej Checkout Session skontrolujte existujúce predplatné, alebo namiesto toho pošlite existujúcich zákazníkov do portálu.
• Odobratie prístupu pri prvom zlyhanom obnovení. Karty zlyhávajú z nudných dôvodov. Krátka lehota s jasným banerom zákazníkov udrží.
• Zabudnutý ostrý webhook. Testovací a ostrý koncový bod majú rôzne podpisové tajomstvá.
• Ignorovanie dane a vrátení. Pred spustením rozhodnite o politike vrátenia a overte si daňové povinnosti u účtovníka.

Predplatné v Mythex

Aplikácie postavené na Mythex používajú váš vlastný účet a kľúče Stripe; pre vašu aplikáciu neexistuje pripojenie na Stripe jedným kliknutím. Pridajte svoje testovacie kľúče a ID cien ako tajomstvá projektu, použite prompty ako vyššie a testujte testovacími kartami Stripe v náhľade. Webhooky potrebujú verejnú URL vašej aplikácie, takže publikujte skôr, než koncový bod zaregistrujete v Stripe, a po prepnutí na ostré kľúče publikujte znova, aby ich živá aplikácia prevzala. Pozrite si Prijímanie platieb cez Stripe a Spracovanie webhookov v backende. Pre širší produkt pokrýva ako vytvoriť SaaS MVP, čo stavať okolo fakturácie.

Otázky