Sida Loo Ku Daro Subscriptions-ka Stripe: Qorshayaasha, Tijaabada, Webhooks iyo Lacag Bixin Fashilmay
Si aad subscriptions-ka Stripe ugu daro, samee alaab leh qiime joogto ah dashboard-ka Stripe, u dir macaamiisha Stripe Checkout oo subscription mode ah server-kaaga, oo ka dhig webhook inuu app-kaaga u sheego markii lacag bixin kasta guulaysato, fashilanto, isbedesho ama dhammaato. Heerka gelitaanka ku salaysii xaaladda subscription-ka ee isticmaalaha, ha ku salaysin bogga guusha. Ku dar badhanka Manage billing kaas oo furaya customer portal-ka martiqaadan ee Stripe si dadku u beddeli karaan kaararka, u beddeli karaan qorshayaasha iyo u joojin karaan, adigoon dhisin bogagaas adigu.
Hagahan wuxuu saldhig u yahay how to add payments to your app, oo daboolaa Checkout mar keliya, test mode iyo live. Halkan waxaan ku xoogeynaynaa waxa u kala duwan lacag-bixinta joogtada ah. Faahfaahinta Stripe waxay ka timid dukumentiyada Stripe laga bilaabo Sebtember 2026.
Maxaa subscriptions-ku uga adag yihiin lacag-bixinta mar keliya
Lacag-bixinta mar keliya waxay dhacdaa intii macmiilku app-ka ku jiro. Subscription-ku wuxuu sii socdaa kadib markii ay ka baxaan: cusbooneysiin bil kasta, kaararka dhacaya, kor u kaca dhexdooda wareegga, iyo joojinno ku dhaca dhammaadka muddada. App-kaagu waxa uu ka maqlaa kuwaas oo keliya webhooks-ka. Inta badan cilladaha subscription-ka waxay ka soo jeedaan markii lacag-bixinta koowaad laga fiirsado inay tahay sheekada oo dhan.
Doorashooyinkaaga
| Habka | Waxa aad dhisayso | Wanaagsan u ah |
|---|---|---|
| Payment Link oo leh qiime joogto ah | Waxba marka laga reebo link | Tijaabinta baahida; maaraynta gelitaanka gacanta |
| Checkout (subscription mode) + customer portal | Route server, webhook, badhan billing | Inta badan apps SaaS iyo xubinnimada |
| Subscriptions API oo leh foom lacag bixin oo aad leedahay | Wax badan: UI-ga lacag bixinta, xaqiijinta, cusbooneysiinta | Apps leh habab billing gaar ah |
| Bixiye merchant-of-record | Waxa ka dhigan Checkout | Iibiyayaasha doonaya in bixiyuhu maamulo cashuurta iibka |
Inta badan apps, Checkout iyo portal-ka ayaa ah isweydaarsiga saxda ah. Ka eeg Stripe vs Paddle vs Lemon Squeezy haddii cashuurta ay kugu welwelsiiso.
Qorshee qiimahaaga Stripe marka hore
Stripe, product waa waxa aad iibinayso ("Pro plan") iyo price waa sida aad u qaadanayso ("$20 bil kasta", "$200 sannad kasta"). Hal product wuxuu leeyahay qiimo dhowr ah. Go'aan:
- Heerarka aad bixinayso iyo waxa mid kasta app-ka ku furo
- Bil kasta, sannad kasta, ama labadaba
- In aad bixinayso tijaabo bilaash ah, iyo haddii ay u baahan tahay kaar hore
Samee alaabta iyo qiimaha test mode, oo hay ID-yada qiimaha; app-kaagu wuu tixraacaa. Haddii aadan wali go'aamin qiimaha, akhri how to price a SaaS product iyo freemium vs free trial.
Wareegga noloshii subscription-ka ee aad u baahan tahay inaad maamusho
Dukumentiyada subscriptions ee Stripe waxay liiyaan xaaladaha subscription-ku yeelan karo. Kuwa ugu muhiimsan gelitaanka:
| Xaaladda | Waxa ay ka dhigan tahay | Gelitaan siiso? |
|---|---|---|
trialing | Muddada tijaabada ah | Haa |
active | Xaalad wanaagsan | Haa |
incomplete | Lacag bixinta koowaad lama dhammaystirin; Stripe wuxuu macmiilka siiyaa 23 saac | Maya |
incomplete_expired | Lacag bixinta koowaad waligeed ma guuleysan | Maya |
past_due | Lacag bixinta ugu dambeysay waa fashilantay ama lama isku dayin; isku dayyo ayaa laga yaabaa inay dhacaan | Doorashadaada; apps badan waxay oggolaadaan muddo yar oo naxariis ah |
unpaid | Isku dayyadii ugu dambeeyay way dhammaadeen, invoices-ka way furan yihiin, isku day dheeri ah ma dhacayo | Maya, Stripe dukumentiyadiisu waxay sheegaan in gelitaanka la joojiyo |
canceled | Way dhammaatay; mar kale looma bilaabi karo | Maya |
paused | Tijaabadii way dhammaatay iyadoon habka lacag bixinta la haysan, waxayna ku noqotay pause | Maya |
Kaydi xaaladda user-kaaga ama account record-kaaga oo gelitaanka ku salaysii. Mar kasta oo webhook khuseeya yimaado, cusbooneysii.
Dhacdooyinka webhook-ka ee loo baahan yahay in la maareeyo
| Dhacdada | Waxa app-kaagu sameeyo |
|---|---|
checkout.session.completed | Ku xidh ID-yada macaamilka Stripe iyo subscription-ka isticmaalahaaga cusub |
invoice.paid | Calaamadee subscription-ka firfircoon oo diiwaan geli wakhtiga dhammaadka wareegga cusub |
invoice.payment_failed | U sheeg isticmaalaha in kaarkiisu fashilmay oo ku xidh portal-ka |
invoice.payment_action_required | Weydii isticmaalaha inuu dhammaystiro xaqiijinta kaarka |
customer.subscription.updated | Cusbooneysii qorshaha, xaaladda, iyo joojinta la qorsheeyay |
customer.subscription.deleted | Ka saar gelitaanka lacag-bixinta |
customer.subscription.trial_will_end | Ku xusuus isticmaalaha ka hor intaan tijaabada dhammaanin; Stripe wuxuu u diraa saddex maalmood ka hor |
Xeerarka handler-ka webhook-ka ee dukumentiyada webhook-ka Stripe ayaa weli khuseeya: hubi saxeexa adigoo isticmaalaya jirka asalka ah, jawaab 2xx si dhakhso ah, maamul duplicates-ka iyo dhacdooyinka aan kala horreyn, oo filo isku-dayga dib-u-celinta. Hagaha what is a webhook wuxuu sharxayaa fikradda, hagaha lacag-bixinta wuxuu liiskeeda faahfaahsan ku leeyahay xeerarka.
Tallaabo tallaabo
- Samee alaabta iyo qiimaha test mode ee Stripe.
- Ku dar secrets: furaha sirta ah, ID-yada qiimaha, iyo markii dambe furaha saxeexa webhook-ka. Ha ku dhigin koodka frontend-ka.
- Bogga qiimaha: badhan kasta oo qorshe ah wuxuu server-kaaga wicitaan u sameeyaa, kaasoo abuuraya Checkout Session subscription mode ah isticmaalaha soo galay. Ku dar user ID-gaaga si webhook-ku u xidho lacag-bixinta akoonka.
- Endpoint-ka webhook: hubi saxeexyada oo maaree dhacdooyinka kor ku xusan, adigoo cusbooneysiinaya hal diiwaan subscription isticmaale kasta.
- Xidh features-ka xaaladda iyo qorshaha la kaydiyay, oo server-ka lagu hubiyo falka kasta oo la ilaaliyo, ma aha oo keliya badhamada la qariyay.
- Customer portal: habee Stripe Dashboard-ka (qorshayaasha dadku u beddeli karaan, haddii ay joojin karaan), kadibna ku dar badhanka Manage billing kaas oo abuuraya portal session server-ka oo u wareejiya.
- Lacag-bixinta fashilmay: settings-ka billing ee Stripe, dooro habka isku-dayga iyo wixii ka dhacaa isku-dayga ugu dambeeya. Muuji banner app-ka inta uu
past_dueyahay. - Tijaabi wareegga oo dhan, kadibna publish samee oo diiwaan geli webhook-ka live-ka.
Prompts-ka aad siinayso AI builder-kaaga
Ku dar lacag-bixinta subscription-ka Stripe. Qorshayaasha: Starter (price ID ku jira STRIPE_PRICE_STARTER) iyo Pro (STRIPE_PRICE_PRO). Bogga qiimaha wuxuu server-ka ku abuuraa Checkout Session subscription mode ah isticmaalaya STRIPE_SECRET_KEY, oo user ID-ga isticmaale soo galay ku daraya. Kaydi Stripe customer ID-ga, subscription ID-ga, qorshaha iyo xaaladda user-ka. Ha u muujin furaha sirta ah browser-ka.
Ku dar POST /api/stripe/webhook. Hubi saxeexa adigoo isticmaalaya STRIPE_WEBHOOK_SECRET iyo jirka asalka ah ee codsiga. Maaree checkout.session.completed, invoice.paid, invoice.payment_failed, customer.subscription.updated, customer.subscription.deleted iyo customer.subscription.trial_will_end. Diiwaan geli ID-yada dhacdooyinka la maareeyay si duplicates-ka loo iska indho tiro. Cusbooneysii xaaladda isticmaalaha subscription object-ka, ma aha dalabyada dhacdooyinku ku yimaadaan.
Ku xidh features-ka Pro server-ka: ogolow kaliya marka xaaladdu tahay active ama trialing iyo qorshaha Pro. Muuji banner "lacag bixintu waa fashilantay, cusbooneysii kaarkaaga" marka uu status-ku yahay past_due. Ku dar badhanka Manage billing kaas oo furaya Stripe customer portal isticmaalahan.
Cusbooneysiinta, hoos u dhigista iyo proration
Marka macmiilku beddelo qorshaha, dukumentiyada Stripe waxay sheegaan in beddelku badanaa abuuro proration: qiimaha cusub waxa loo dabaqaa wareegga billing-ka ee hadda ka hadhay. Waxaad hore u eegi kartaa prorations-ka ama aad damin kartaa. Haddii qorshayaashu isku mid yihiin, taariikhaha billing-ku way joogaan; ka bil ilaa sannad, taariikhda billing-ku waxay u guurtaa maalinta beddelka. Ka tagida macaamiisha inay beddelaan qorshayaasha portal-ka waxay kaa badbaadinaysaa inaad qorto mantiqa, laakiin ku go'aamii settings-ka portal-ka beddelada la oggol yahay.
Liiska tijaabada
Isticmaal Stripe test mode iyo kaararka tijaabada, oo mar kasta gudub gobol kasta:
- Subscription cusub wuxuu siiyaa qorshaha saxda ah isticmaalaha saxda ah
- Xidhista tab-ka isla markaas kadib lacag bixinta weli waxay siisaa gelitaan (caddaynaya in webhook-ku shaqeeyo)
- Kaar la diiday markii la diiwaangelinayo ma siiso wax
- Cusbooneysiin fashilanta ayaa akoonka geynta past_due oo banner-ka muujinaysa
- Kaarka portal-ka oo la cusbooneysiiyo waxay soo celinaysaa xaaladda active
- Kor u kaca iyo hoos u dhaca waxay beddelaan features-ka saxda ah
- Joojinta wareegga dhammaadka waxay hayn gelitaanka ilaa taariikhda dhammaadka, kadibna ka saartaa
- Isticmaalayaasha tijaabada waxay helaan gelitaan, xusuusin, oo waxay u beddelaan ama lumiyaan gelitaanka saxda ah
- Isla webhook dhacdada laba jeer loo diro wax kama beddelo
Stripe test clocks-ka waxay ku oggolaanayaan inaad sahamiso wakhtiga oo socda, sidaas darteed waxaad tijaabin kartaa cusbooneysiinta iyadoon sugin bil. Hubi dukumentiyada tijaabada ee Stripe ee hadda si aad u ogaato sida loo isticmaalo.
Khaladaadka caadiga ah
- Gelitaan siinta bogga guusha. Macaamiishu way bixin karaan kadibna ma gaari karaan. Isticmaal webhook.
- Oo keliya lacag-bixinta koowaad la maareeyo. Cusbooneysiinta, fashilka iyo joojinta waxay yimaadaan hadal ahaan dambe, dhacdooyin ahaan.
- Xaaladda qorshaha oo keliya frontend-ka lagu hubiyo. Qof kasta ayaa API-gaaga wici karaa.
- Hal isticmaale, subscriptions badan si aan loo doonin. Hubi subscription jira ka hor intaadan abuurin Checkout Session cusub, ama u dir macaamiisha hore portal-ka.
- Gelitaanka joojinta cusbooneysiinta kowaad ee fashilanta. Kaararka way fashilmaan sababo caadi ah. Muddo yar oo naxariis ah iyo banner cad ayaa macaamiisha ilaalinaya.
- Webhook-ka live-ka oo la illoobay. Endpoint-yada test iyo live waxay leeyihiin furayaal saxeexa kala duwan.
- Cashuurta iyo celinta oo la iska indho tiro. Go'aan siyaasadda celinta, oo cashuurtaada hubi xisaabiye ka hor intaadan bilaabin.
Subscriptions Mythex
Apps aad dhisto Mythex-ka waxay isticmaalaan akoonkaaga gaarka ah ee Stripe iyo furayaashiisa; ma jiro isku xidhid hal-riix ah oo Stripe ah oo app-kaaga. Ku dar furayaashaada tijaabada iyo ID-yada qiimaha secrets ahaan mashruuca, isticmaal prompts-ka kor ku xusan, oo tijaabi kaararka tijaabada Stripe ee Preview. Webhooks-ku waxay u baahan yihiin URL dadweyne oo app-kaaga ah, sidaas darteed publish samee ka hor intaadan diiwaan geliyin endpoint-ka Stripe, kadibna mar kale publish samee markaad u beddesho furayaasha live-ka si app-ka live-ka uu u qaato. Eeg Accept payments with Stripe iyo Handle webhooks in your backend. Alaabta ballaadhan, how to build a SaaS MVP wuxuu daboolaa waxa lagu dhisayo billing-ka ku wareegsan.
Su'aalaha
Waa habka ugu fudud ee subscriptions-ka Stripe lagu daro?
Samee alaab oo leh qiime joogto ah dashboard-ka Stripe, u dir macaamiisha Stripe Checkout oo subscription mode ah, maaree dhacdooyinka subscription-ka webhook, kana xiri badhanka Manage billing portal-ka martiqaadan ee Stripe ee macaamiisha. Taasi waxay ka badbaadisaa inaad dhisto foomamka kaarka iyo shaashadaha beddelka qorshaha adigu naftaadu.
Webhook-yada Stripe ee subscriptions-ka maxaan u baahanahay?
Ugu yaraan checkout.session.completed si aad subscription-ka cusub ugu xidho isticmaalahaaga, invoice.paid si aad u xaqiijiso lacag bixin kasta oo guuleysatay, invoice.payment_failed si aad u digto cusbooneysiin fashilmay, iyo customer.subscription.updated iyo customer.subscription.deleted si aad u raadiso beddelka qorshaha iyo joojinta.
Maxaa dhaca markii lacag bixinta subscription-ka fashilanto?
Sida dukumentiyada Stripe ay sheegayaan laga bilaabo Sebtember 2026, subscription-ku badanaa wuxuu noqdaa past_due, Stripe waxa uu isku dayi karaa lacag bixinta iyadoo lagu salaynayo settings-kaaga. Isku dayga ugu dambeeya ka dib, settings-ka Dashboard-ka ayaa go'aamiya in la joojiyo, la calaamadeeyo unpaid, ama uu ku sii hadho past_due.
Ma bixin karaa tijaabo bilaash ah iyadoon kaarka la weydiinin?
Haa. Stripe wuxuu taageeraa tijaabada bilaashka ah, dukumentiyadiisuna waxay sharxayaan xaalad paused ah tijaabooyinka dhamaada iyadoon habka lacag bixinta la haysan, haddii si sidaas ah loo habeeyo. Kaarka hore loo qaado badanaa waxay keentaa diiwaan-gelin yar laakiin macaamil bixiyaal badan; tijaabi wixii alaabtaadu u habboon.