Kako dodati pretplate sa Stripeom: planovi, probna razdoblja, webhookovi i neuspjela plaćanja

Za dodavanje pretplata sa Stripeom u Stripe nadzornoj ploči napravite proizvod s ponavljajućom cijenom, pošaljite kupce na Stripe Checkout u načinu pretplate sa svog poslužitelja i pustite da webhook javi vašoj aplikaciji kada svako plaćanje uspije, ne uspije, promijeni se ili završi. Status pretplate spremite uz korisnika i pristup dodjeljujte prema tome, a ne prema stranici za uspjeh. Dodajte gumb Upravljaj naplatom koji otvara Stripeov hostirani portal za kupce, pa ljudi mogu mijenjati kartice, prebacivati planove i otkazivati bez da vi gradite te zaslone.

Ovaj vodič nadovezuje se na kako dodati plaćanja u aplikaciju, koji pokriva jednokratni Checkout, testni način rada i puštanje u rad. Ovdje se fokusiramo na ono što je drugačije kod ponavljajuće naplate. Podaci o Stripeu su iz Stripeove dokumentacije od rujna 2026.

Zašto su pretplate teže od jednokratnih plaćanja

Jednokratno plaćanje događa se dok je kupac u vašoj aplikaciji. Pretplata se nastavlja i nakon što ode: mjesečne obnove, kartice kojima istekne rok, nadogradnje usred ciklusa, otkazivanja koja stupaju na snagu na kraju razdoblja. Vaša aplikacija o tome saznaje samo preko webhookova. Većina grešaka s pretplatama dolazi od toga da se prvo plaćanje tretira kao cijela priča.

Vaše mogućnosti

Za većinu aplikacija Checkout plus portal je pravi kompromis. Usporedite pružatelje u Stripe vs Paddle vs Lemon Squeezy ako vas brine obrada poreza.

Prvo isplanirajte cijene u Stripeu

U Stripeu je proizvod ono što prodajete („Pro plan”), a cijena je kako to naplaćujete („20 $ mjesečno”, „200 $ godišnje”). Jedan proizvod može imati više cijena. Odlučite:

• Koje razine nudite i što svaka otključava u vašoj aplikaciji
• Mjesečno, godišnje ili oboje
• Nudite li probno razdoblje i treba li ono karticu unaprijed

Proizvode i cijene napravite u testnom načinu rada i čuvajte njihove ID-jeve cijena; vaša aplikacija se na njih poziva. Ako cijene još niste dogovorili, pročitajte kako odrediti cijenu SaaS proizvoda i freemium ili besplatno probno razdoblje.

Životni ciklus pretplate koji morate obraditi

Stripeov pregled pretplata navodi statuse koje pretplata može imati. Oni koji su najvažniji za pristup:

Spremite status na svoj zapis korisnika ili računa i na njemu temeljite pristup. Ažurirajte ga svaki put kada stigne relevantan webhook.

Webhook događaji koje treba obraditi

Pravila za handlere iz Stripeove dokumentacije za webhookove i dalje vrijede: provjerite potpis koristeći sirovo tijelo, brzo vratite 2xx, obradite duplikate i događaje izvan redoslijeda te računajte na ponovne isporuke. Što je webhook objašnjava ideju, a vodič o plaćanjima navodi pravila detaljno.

Korak po korak

1. Napravite proizvode i cijene u Stripe testnom načinu rada.
2. Dodajte tajne: tajni ključ, ID-jeve cijena i kasnije tajni ključ za potpisivanje webhooka. Nikada ih ne stavljajte u kod na frontendu.
3. Stranica s cijenama: gumb svakog plana poziva vaš poslužitelj, koji stvara Checkout sesiju u načinu pretplate za prijavljenog korisnika. Proslijedite svoj ID korisnika kako bi webhook mogao uplatu povezati s računom.
4. Webhook krajnja točka: provjerava potpise i obrađuje gore navedene događaje, ažurirajući jedan zapis pretplate po korisniku.
5. Otključavajte značajke prema spremljenom statusu i planu, provjerenim na poslužitelju za svaku zaštićenu radnju, a ne samo prema gumbovima.
6. Portal za kupce: konfigurirajte ga u Stripe nadzornoj ploči (na koje planove ljudi mogu prijeći, mogu li otkazati), zatim dodajte gumb Upravljaj naplatom koji na poslužitelju stvara sesiju portala i preusmjerava na nju.
7. Neuspjela plaćanja: u postavkama naplate u Stripeu odaberite ponašanje ponovnih pokušaja i što se događa nakon posljednjeg. Prikažite banner u aplikaciji dok je status past_due.
8. Testirajte cijeli životni ciklus, zatim objavite i registrirajte živi webhook.

Upute za vaš AI alat za izradu

Dodaj naplatu pretplata sa Stripeom. Planovi: Starter (ID cijene u STRIPE_PRICE_STARTER) i Pro (STRIPE_PRICE_PRO). Stranica s cijenama stvara Checkout sesiju u načinu pretplate na poslužitelju koristeći STRIPE_SECRET_KEY, s ID-jem prijavljenog korisnika. Spremi Stripe ID kupca, ID pretplate, plan i status na korisnika. Nikada ne izlažite tajni ključ pregledniku.

Dodaj POST /api/stripe/webhook. Provjeri potpis pomoću STRIPE_WEBHOOK_SECRET koristeći sirovo tijelo zahtjeva. Obradi checkout.session.completed, invoice.paid, invoice.payment_failed, customer.subscription.updated, customer.subscription.deleted i customer.subscription.trial_will_end. Bilježi ID-jeve obrađenih događaja da se duplikati zanemare. Ažuriraj status korisnika prema objektu pretplate, a ne prema redoslijedu kojim događaji stižu.

Otključavaj Pro značajke na poslužitelju: dopusti ih samo kada je status active ili trialing i plan je Pro. Prikaži banner „Plaćanje nije uspjelo, ažuriraj karticu” kada je status past_due. Dodaj gumb Upravljaj naplatom koji otvara Stripe portal za kupce za ovog korisnika.

Nadogradnje, smanjenja i proporcionalna naplata

Kada kupac promijeni plan, Stripeova dokumentacija kaže da promjena često stvara proraciju (proration): nova cijena primjenjuje se na ostatak tekućeg razdoblja naplate. Proračune možete pregledati ili ih isključiti. Ako planovi imaju isti interval, datumi naplate ostaju isti; prijelaz s mjesečnog na godišnje pomiče datum naplate na dan promjene. Dopuštanje kupcima da mijenjaju planove u portalu štedi vam pisanje te logike, ali u postavkama portala odlučite koje su promjene dopuštene.

Popis za testiranje

Koristite Stripe testni način rada i testne kartice te prođite svako stanje:

• Nova pretplata daje pravi plan pravom korisniku
• Zatvaranje kartice odmah nakon plaćanja i dalje daje pristup (dokazuje da webhook radi)
• Odbijena kartica pri registraciji ne daje ništa
• Obnova koja ne uspije stavlja račun u past_due i prikazuje banner
• Ažuriranje kartice u portalu vraća status active
• Nadogradnja i smanjenje plana ispravno mijenjaju značajke
• Otkazivanje na kraju razdoblja zadržava pristup do krajnjeg datuma, zatim ga uklanja
• Korisnici u probnom razdoblju dobivaju pristup, podsjetnik i pravilno prelaze u plaćanje ili gube pristup
• Slanje istog webhook događaja dvaput ništa ne mijenja

Stripeovi testni satovi (test clocks) omogućuju simulaciju prolaska vremena, pa možete testirati obnove bez čekanja mjesec dana. Provjerite trenutne Stripeove dokumente za testiranje za način korištenja.

Česte greške

• Davanje pristupa na stranici za uspjeh. Kupci mogu platiti i nikada je ne vidjeti. Koristite webhook.
• Obrada samo prvog plaćanja. Obnove, neuspjesi i otkazivanja stižu kasnije, kao događaji.
• Provjera statusa plana samo na frontendu. Svatko može izravno pozvati vaš API.
• Slučajno jedan korisnik, mnogo pretplata. Prije stvaranja nove Checkout sesije provjerite postoji li već pretplata ili pošaljite postojeće kupce na portal.
• Oduzimanje pristupa pri prvoj neuspjeloj obnovi. Kartice ne uspijevaju iz dosadnih razloga. Kratko razdoblje milosti s jasnim banerom zadržava kupce.
• Zaboravljen živi webhook. Testne i žive krajnje točke imaju različite tajne ključeve za potpis.
• Ignoriranje poreza i povrata. Odlučite politiku povrata i provjerite porezne obveze s računovođom prije puštanja u rad.

Pretplate na Mythexu

Aplikacije koje gradite na Mythexu koriste vaš vlastiti Stripe račun i ključeve; ne postoji povezivanje Stripea jednim klikom za vašu aplikaciju. Dodajte testne ključeve i ID-jeve cijena kao tajne projekta, koristite upute poput gornjih i testirajte s Stripeovim testnim karticama u pregledu. Webhookovi trebaju javnu adresu vaše aplikacije, pa objavite prije registracije krajnje točke u Stripeu, a ponovno objavite nakon prelaska na žive ključeve kako bi živa aplikacija preuzela nove vrijednosti. Pogledajte Prihvaćanje plaćanja sa Stripeom i Obrada webhookova u backendu. Za širi proizvod, kako izraditi SaaS MVP pokriva što graditi oko naplate.

Pitanja