Hvernig bætir þú áskriftum með Stripe við appið: áætlanir, prufutímabil, webhook og misheppnaðar greiðslur

Til að bæta áskriftum með Stripe við app skaltu búa til vöru með endurteknu verði í Stripe-mælaborðinu, senda viðskiptavini á Stripe Checkout í áskriftarham frá þjóninum þínum, og láta webhook segja appinu þínu þegar hver greiðsla tekst, mistekst, breytist eða lýkur. Geymdu áskriftarstöðuna á notandanum og veittu aðgang út frá henni, ekki út frá árangurssíðunni. Bættu við hnappinum Stjórna innheimtu sem opnar hýstu þjónustugátt Stripe, svo fólk geti skipt um kort, skipt um áætlun og sagt upp án þess að þú smíðir þessar skjámyndir.

Þessi leiðbeining byggir á hvernig bætir þú greiðslum við appið þitt, sem fjallar um einskiptis-Checkout, prufuham og opnun fyrir raunverulegar greiðslur. Hér einblínum við á það sem er öðruvísi við endurtekna innheimtu. Upplýsingar um Stripe eru úr skjölum Stripe frá september 2026.

Af hverju áskriftir eru erfiðari en einskiptisgreiðslur

Einskiptisgreiðsla gerist meðan viðskiptavinurinn er í appinu þínu. Áskrift heldur áfram eftir að hann er farinn: endurnýjanir í hverjum mánuði, kort sem renna út, uppfærslur á miðju tímabili og uppsagnir sem taka gildi í lok tímabils. Appið þitt fréttir af þessu aðeins í gegnum webhook. Flestar villur í áskriftum koma til af því að fyrstu greiðslunni er litið á sem alla söguna.

Valkostirnir þínir

Fyrir flest öpp er Checkout ásamt þjónustugáttinni rétta málamiðlunin. Berðu saman þjónustur í Stripe vs Paddle vs Lemon Squeezy ef skattameðferð veldur þér áhyggjum.

Skipuleggðu verðlagninguna í Stripe fyrst

Í Stripe er vara það sem þú selur („Pro-áætlun“) og verð er hvernig þú rukkar fyrir hana („$20 á mánuði“, „$200 á ári“). Ein vara getur haft nokkur verð. Ákveddu:

• Hvaða þrep þú býður og hvað hvert þeirra opnar í appinu þínu
• Mánaðarlega, árlega eða hvort tveggja
• Hvort þú býður prufutímabil, og hvort það krefst korts strax

Búðu til vörur og verð í prufuham og geymdu verðauðkennin; appið þitt vísar í þau. Ef þú hefur ekki ákveðið verðlagningu skaltu lesa hvernig verðleggur þú SaaS-vöru og frímíum eða ókeypis prufutímabil.

Líftími áskriftarinnar sem þú þarft að meðhöndla

Skjöl Stripe um áskriftir telja upp þær stöður sem áskrift getur haft. Þær sem skipta mestu fyrir aðgang eru:

Geymdu stöðuna á notanda- eða reikningsfærslunni þinni og byggðu aðgang á henni. Uppfærðu hana í hvert skipti sem viðeigandi webhook berst.

Webhook-atburðirnir sem þarf að meðhöndla

Reglur um meðhöndlun úr skjölum Stripe um webhook gilda enn: staðfestu undirskriftina með hráa meginmálinu, svaraðu hratt með 2xx, meðhöndlaðu tvítekna og óraðaða atburði og gerðu ráð fyrir endursendingum. Leiðbeiningin hvað er webhook útskýrir hugmyndina, og greiðsluleiðbeiningin listar reglurnar í smáatriðum.

Skref fyrir skref

1. Búðu til vörur og verð í prufuham Stripe.
2. Bættu við leyndarmálum: leyndarlyklinum, verðauðkennunum og síðar undirskriftarleyndarmáli webhook. Settu þau aldrei í kóða framendans.
3. Verðsíðan: hnappur hverrar áætlunar kallar á þjóninn þinn, sem býr til Checkout-lotu í áskriftarham fyrir innskráða notandann. Sendu auðkenni notandans með svo webhook geti tengt greiðsluna við aðganginn.
4. Endapunktur webhook: staðfestu undirskriftir og meðhöndlaðu atburðina hér að ofan, og uppfærðu eina áskriftarfærslu fyrir hvern notanda.
5. Læstu eiginleikum á geymdri stöðu og áætlun, athugað á netþjóninum í hverri verndaðri aðgerð, ekki bara í földum hnöppum.
6. Þjónustugáttin: stilltu hana í Stripe-mælaborðinu (hvaða áætlanir fólk getur skipt yfir í, hvort það getur sagt upp), bættu síðan við hnappinum Stjórna innheimtu sem býr til gáttarlotu á þjóninum og vísar notandanum þangað.
7. Misheppnaðar greiðslur: í innheimtustillingum Stripe velurðu hvernig endurtekningum er háttað og hvað gerist eftir síðustu endurtekningu. Sýndu borða í appinu meðan staðan er past_due.
8. Prófaðu allt lífsskeiðið, birtu síðan og skráðu raunverulegan webhook-endapunkt.

Fyrirmæli fyrir gervigreindarsmiðinn þinn

Bættu við áskriftagreiðslum með Stripe. Áætlanir: Starter (verðauðkenni í STRIPE_PRICE_STARTER) og Pro (STRIPE_PRICE_PRO). Verðsíðan býr til Checkout-lotu í áskriftarham á netþjóninum með STRIPE_SECRET_KEY, með auðkenni innskráða notandans áfestu. Vistaðu Stripe-viðskiptavinarauðkenni, áskriftarauðkenni, áætlun og stöðu á notandanum. Láttu leyndarlykilinn aldrei birtast í vafranum.

Bættu við POST /api/stripe/webhook. Staðfestu undirskriftina með STRIPE_WEBHOOK_SECRET með hráa meginmálinu. Meðhöndlaðu checkout.session.completed, invoice.paid, invoice.payment_failed, customer.subscription.updated, customer.subscription.deleted og customer.subscription.trial_will_end. Skráðu auðkenni afgreiddra atburða svo tvítekningar séu hunsaðar. Uppfærðu stöðu notandans út frá áskriftarhlutnum, ekki út frá röðinni sem atburðirnir berast í.

Læstu Pro-eiginleikum á netþjóninum: leyfðu þá aðeins þegar staðan er active eða trialing og áætlunin er Pro. Sýndu borðann „greiðsla mistókst, uppfærðu kortið“ þegar staðan er past_due. Bættu við hnappinum Stjórna innheimtu sem opnar þjónustugátt Stripe fyrir þennan notanda.

Uppfærslur, niðurfærslur og hlutfallsleg innheimta

Þegar viðskiptavinur skiptir um áætlun segja skjöl Stripe að breytingin skapi oft hlutfallslega innheimtu (proration): nýja verðið gildir fyrir það sem eftir er af núverandi innheimtutímabili. Þú getur forskoðað hlutfallslegar upphæðir eða slökkt á þeim. Ef áætlanirnar hafa sama millibil haldast innheimtudagsetningar; ef farið er úr mánaðarlegu í árlegt færist innheimtudagurinn yfir á daginn sem skipt var. Ef viðskiptavinir breyta áætlun í gáttinni sparar þú þér að skrifa þessa rökfræði, en ákveddu í stillingum gáttarinnar hvaða breytingar eru leyfðar.

Prófunarlisti

Notaðu prufuham Stripe og prufukort, og farðu í gegnum hvert ástand:

• Ný áskrift veitir rétta áætlun til rétta notandans
• Að loka vafraglugganum strax eftir greiðslu veitir samt aðgang (sannar að webhook virkar)
• Hafnað kort við skráningu veitir ekkert
• Endurnýjun sem mistekst setur reikninginn í past_due og sýnir borðann
• Að uppfæra kortið í gáttinni endurheimtir stöðuna active
• Uppfærslur og niðurfærslur breyta eiginleikum rétt
• Uppsögn í lok tímabils heldur aðgangi til lokadagsetningar, síðan er honum eytt
• Notendur í prufutímabili fá aðgang, fá áminninguna og breytast eða missa aðgang rétt
• Að senda sama webhook-atburð tvisvar breytir engu

Tímaklukkur í prófunum Stripe gera þér kleift að herma eftir því að tíminn líði, svo þú getur prófað endurnýjanir án þess að bíða í mánuð. Skoðaðu núgildandi prófunarskjöl Stripe til að sjá hvernig þær eru notaðar.

Algeng mistök

• Að veita aðgang á árangurssíðunni. Viðskiptavinir gætu greitt og aldrei náð henni. Notaðu webhook.
• Að meðhöndla aðeins fyrstu greiðsluna. Endurnýjanir, misheppnanir og uppsagnir berast síðar sem atburðir.
• Að athuga áætlunarstöðu aðeins í framendanum. Hver sem er getur kallað beint á API-ið þitt.
• Ein notandi, margar áskriftir fyrir slysni. Athugaðu hvort áskrift sé þegar til áður en ný Checkout-lota er búin til, eða sendu núverandi viðskiptavini í gáttina.
• Afturkalla aðgang við fyrstu misheppnuðu endurnýjun. Kort mistakast af leiðinlegum ástæðum. Stutt náðarfrestur með skýrum borða heldur viðskiptavinum.
• Gleymt raunverulega webhook-inu. Prufu- og raunverulegir endapunktar hafa mismunandi undirskriftarleyndarmál.
• Að hunsa skatta og endurgreiðslur. Ákveddu endurgreiðslustefnu og athugaðu skattskyldur þínar með endurskoðanda áður en þú opnar.

Áskriftir í Mythex

Öpp sem þú smíðar á Mythex nota þinn eigin Stripe-reikning og lykla; það er engin tenging við Stripe með einum smelli fyrir appið þitt. Bættu prufulyklum þínum og verðauðkennum við sem leyndarmál verkefnisins, notaðu fyrirmæli eins og þau hér að ofan og prófaðu með prufukortum Stripe í Preview. Webhook þurfa opna vefslóð appsins þíns, svo birtu áður en þú skráir endapunktinn í Stripe, og birtu aftur eftir að þú skiptir yfir í raunverulega lykla svo raunverulega appið noti þá. Sjá Taka við greiðslum með Stripe og Meðhöndla webhook í bakendanum þínum. Fyrir heildarvöruna fjallar hvernig býrð þú til SaaS MVP um það sem þarf að smíða í kringum innheimtuna.

Spurningar