Sida Loo Ku Daro Lacag Bixinta App-ka: Checkout, Subscriptions iyo Webhooks

Habka ugu fudud ee lacag bixinta lagu daro app-kaaga waa Stripe: isticmaal Payment Link haddii aad u baahan tahay oo keliya badhanka "Buy" oo aad dalabyada gacanta ku maamuli karto, Stripe Checkout haddii app-kaagu u baahan yahay inuu ogaado qofka bixiyay oo uu si otomaatig ah uga jawaabo, iyo Checkout oo leh subscription mode oo ay lug ku leedahay portal-ka macaamiisha ee Stripe lacag bixinta joogtada ah. Dhammaan kiisaska marka laga reebo kan ugu fudud, waxaad u baahan tahay sidoo kale webhook — endpoint server kaaga ah oo Stripe wicitaan u sameeyo markii lacag bixintu guuleysato — waana inaad wax walba ku tijaabiso furayaasha test-ka iyo kaararka tijaabada ee Stripe ka hor intaadan u beddelin furayaasha live.

Hagahan wuxuu sharxayaa qaab kasta, qaybta webhook-ka ee casharada badan ka tegaan, iyo waxa laga hubiyo ka hor inta aadan lacag dhab ah qaadan. Faahfaahinta Stripe waxay ka timid dukumentiyadiisa Sebtember 2026.

Sababta loo isticmaalo bixiye lacag bixin

Mar weligaa ha ururin lambarada kaararka foomamkaaga. Xogta kaarka oo kaliya u maareynta waxay kugu keenaysaa xadka PCI DSS (heerka amniga warshadaha kaararka) waxayna tahay khatar weyn. Bixiye lacag bixin sida Stripe wuxuu martiqaadaa foomka lacag bixinta, kaarka wuu kaydiyaa, wuxuu maamulaa xaqiijinta bangiga, wuxuuna app-kaaga u sheegaa natiijada. App-kaagu waxa uu weligiis arkaa oo keliya "macmiil X wuxuu bixiyay Y".

Hagahan wuxuu isticmaalaa Stripe maxaa yeelay waa mid si ballaaran loo isticmaalo, dukumentiyo wanaagsan leh, oo inta badan AI app builders-ka taageeraan. Bixiyayaal kale ayaa jira, qaarkoodna waxay u shaqeeyaan sida "merchant of record" oo qaata maamulka cashuurta iibka adiga kuu hadha; haddii wax ka qabashada cashuurtu kugu welwelsiiyso, qaabkaas waa mid lagu tixgelin karo.

Saddexda habood ee lacag bixinta Stripe

Payment Links

Payment Link waa bog lacag bixin oo Stripe martiqaado oo aad ku abuurto dashboard-ka Stripe adigoon code qorin. Waxaad heshaa URL aad ku dhigi karto badhan app-ka gudihiisa, aad la wadaagto email, ama aad u muujiso QR code. Dukumentiyada Stripe waxay sheegaan in Payment Links ay iibin karaan alaab, subscription, ama ay aqbali karaan carro-bixin, waxaana suurtagal ah in macaamiishu doortaan waxa ay bixinayaan ama tirada iibka la xaddido.

Dhibaatada ayaa ah: app-kaagu si toos ah uma ogaanayo in isticmaale gaar ah oo soo galay uu bixiyay. Bog carro-bixin ama dukaan yar oo aad dalabyada gacanta ugu gudbiso adigoo ka raacaya ogeysiisyada email-ka ee Stripe, taasi waa fiican tahay. Laakiin "bixi si aad Pro features-ka u furto", taasi ma aha.

Stripe Checkout

Checkout waa bog lacag bixin oo server-kaagu u abuuro markii la codsado iibka gaarka ah. Server-kaagu wuxuu u sheegaa Stripe waxa la iibsanayo (iyo ikhtiyaar ahaan macmiilka iibsanaya), Stripe wuxuu soo celinayaa URL, adna macmiilka ayaad u diraysaa. Dukumentiyada Stripe waxay sharxayaan inuu taageero mar keliya iyo subscription labadaba, sida bog buuxa oo Stripe martiqaado, bog ku dhex jira websaydhkaaga, ama foom ku dhex jirta.

Habka:

1. Macmiilku wuxuu riixaa Buy app-ka.
2. Server-kaagu wuxuu abuuraa Checkout Session adigoo isticmaalaya furahaaga sirta ah, oo ku daraya ID ku xidhaysa isticmaalahaaga ama dalabkaaga.
3. Macmiilka waxaa loo wareejiyaa Stripe, kaddibna wuu bixiyaa.
4. Stripe wuxuu dib ugu celiyaa bogga guusha.
5. Stripe wuxuu u diraa dhacdada checkout.session.completed webhook-kaaga, server-kaaguna wuxuu calaamadeeyaa dalabka la bixiyay ama wuxuu furaa gelitaanka.

Tallaabada 2aad waa in ay ku dhacdo server-ka, sababtoo ah waxay isticmaashaa furahaaga sirta ah. Taasi waa sababta ugu weyn ee Checkout u baahan yahay backend.

Subscriptions

Subscriptions waxay isticmaalaan Checkout oo leh subscription mode iyo qiime joogto ah oo aad ku samaysay Stripe. Lacag bixinta ugu horreysa waxay u shaqeysaa sida habka kor ku xusan. Kadib, cusbooneysiinta, kaararka fashilmay, kor u kaca iyo joojinta ayaa waqti ku dhaca — inta badan markii macmiilku aanu app-ka ku jirin — sidaas darteed app-kaagu wuxuu ka ogaadaa oo keliya webhooks-ka.

Macmiilka inuu maamulo subscription-kiisa, Stripe wuxuu bixiyaa customer portal martiqaadan. Sida dukumentiyada Stripe ay sheegayaan, macaamiishu halkaas ayay ka cusbooneysiin karaan habka lacag bixinta iyo faahfaahinta billing-ka, beddeli karaan ama joojin karaan subscriptions-ka, waxayna ka arki karaan oo soo dejisan karaan invoices-ka. Waxaad ku habeysaa dashboard-ka Stripe waxaadna ku dartaa badhanka "Manage billing" kaas oo macmiilka u diraya. Taasi waxay kaa badbaadinaysaa inaad naftaadu dhisto bogagaas.

Webhooks: qaybta aan la dhaaftin karin

Webhook waa codsi HTTP ah oo Stripe u diro server-kaaga markii wax dhacaan. (Eeg what a webhook is fikradda guud.) Hagaha fulinta ee Stripe wuxuu si cad u sheegay: bogga guusha keli ahaan lagama tiirin karo si loo fuliyo dalabyada, maadaama macmiilku lacag bixin karo kadibna isku xidhiidhka uu lumiyo ka hor inta bogaasi soo gelin. Subscriptions-ka iyo hababka lacag bixinta dib u dhaca, webhooks-ku waa lagama maarmaan.

Dhacdooyinka mudan in la maareeyo

Xeerarka webhook handler-ka saxda ah

Kuwan waxay ka soo jeedaan dukumentiyada webhook-ka ee Stripe, handler-yada AI-ga la sameeyay mararka qaarkood mid ka mid ah ayay ka luntaan:

• Hubi saxeexa. Dhacdo kasta waxay ka kooban tahay header-ka Stripe-Signature. Handler-kaagu wuxuu hubiyaa adigoo isticmaalaya furaha saxeexa endpoint-ka (wuxuu ku bilaabmaa whsec_). Aadaan taas la'aanteed, qof kasta wuxuu server-kaaga u diri karaa "lacag waa la bixiyay" been ah.
• Isticmaal jirka codsiga ee asalka ah. Hubinta saxeexu way fashilantaa haddii framework-kaagu horey u falanqeeyo ama beddelo jirka.
• Jawaab 2xx si dhakhso leh u celi, kadibna samee shaqada gaabisa. Waqtiga dhaafa waxaa loo tiriyaa fashil.
• Ka dhig duplicates-ka. Stripe waxa laga yaabaa inuu dhacdo isku mid ah ka dhigo in ka badan hal mar. Diiwaan geli ID-yada dhacdooyinka la maareeyay, ama ka dhig fulinta si ammaan ah in labo jeer la fuliyo.
• Ha u malaynin amar. Stripe ma xaqiijiyo in dhacdooyinku ku yimaadaan siday dhacen.
• Filo dib-u-isku-dayo. Mode-ka live-ka, Stripe wuxuu dib u isku dayaa gudbinta fashilantay ilaa saddex maalmood, sidaas darteed joojin gaaban uma lumin lacag bixinta — laakiin handler-kaagu waa inuu la qabsadaa dhacdooyinka daahay.

Webhooks-ku waxay u baahan yihiin cinwaan HTTPS oo dadweyne ah, sidaas darteed badanaa waxay shaqeeyaan kaliya markii app-kaagu publish gareeyo (CLI-ga Stripe wuxuu dhacdooyinka u gudbin karaa kombiyuutarka horumariyaha).

Prompt-ka dhammaan habka daboolaya

Ku dar iibsashada mar keliya ee Stripe Checkout ee "Pro pack" (price ID ku jira STRIPE_PRICE_ID). Samee Checkout Session server-ka adigoo isticmaalaya STRIPE_SECRET_KEY ee secrets-ka, oo ku dar user ID-ga isticmaale soo galay session-ka. Ku dar endpoint POST /api/stripe/webhook oo hubiya saxeexa Stripe adigoo isticmaalaya STRIPE_WEBHOOK_SECRET iyo jirka codsiga ee asalka ah, oo maareeya checkout.session.completed, kaddibna calaamadee isticmaalahaas inuu leeyahay Pro pack-ka. Ka dhig mid ammaan ah haddii isla dhacdadu gaarto labo jeer. Bogag guusha iyo joojinta. Furaha sirta ah ha u muujin browser-ka.

Subscriptions-ka, ku dar: "Isticmaal subscription mode oo leh STRIPE_PRICE_ID. Maaree invoice.paid, invoice.payment_failed, customer.subscription.updated iyo customer.subscription.deleted. Ku dar badhan Manage billing oo furta Stripe customer portal."

Test mode

Stripe wuxuu leeyahay deegaano gaar ah oo sandbox (test) iyo live oo furayaal kala duwan leh. Furayaasha sandbox waxay ku bilaabmaan pk_test_, sk_test_ ama rk_test_; furayaasha live waxay ku bilaabmaan pk_live_, sk_live_ ama rk_live_. Macaamilada tijaabada lacag dhab ah ma dhaqaajiyaan.

Kaararka tijaabada ee waxtarka leh ee dukumentiyada tijaabada Stripe (taariikh dhacaysa mustaqbalka, CVC saddex lambar):

Tijaabi ugu yaraan:

• Lacag bixin guuleysatay ayaa furta waxa saxda ah isticmaalaha saxda ah
• Kaar la diiday ayaa muujiya fariin cad, wax furana ma jiro
• Xidhista tab-ka browser-ka isla markaas kadib lacag bixinta weli waxay keenaysaa gelitaan (taasi waxay caddaynaysaa in webhook-ku shaqeeyo, ma aha bogga guusha oo keliya)
• Joojinta bogga Stripe waxay isticmaalaha ku celinaysaa app-ka iyadoon wax lacag ah laga qaadin
• Subscriptions-ka: ka jar customer portal-ka oo hubi in gelitaanku dhammaado waqtiga saxda ah

Marka live-ka

1. Hawlgeli akoonka Stripe oo leh faahfaahinta ganacsigaaga iyo bangiga.
2. Beddel furayaasha live-ka secrets-ka app-kaaga. Stripe wuxuu talinayaa furayaal xaddidan oo leh oggolaanshaha integration-kaaga oo keliya, halkii furaha sirta ah ee aan xadidnayn.
3. Samee endpoint webhook live ah oo u tilmaamaya app-ka aad publish gareysay. Waxay leedahay furaha saxeexa u gaar ah, oo ka duwan kan test-ka — cusbooneysii.
4. Dib u samee products iyo prices mode-ka live-ka; ID-yada mode-ka test-ka halkaas ma jiraan.
5. Samee hal iibsi yar oo dhab ah kadibna soo celi lacagta.

Furaha oo dhan ku hay secrets-ka mashruucaaga, weligaaba ha ku dhigin code ama chat. Liiska hubinta amniga wuxuu si faahfaahsan u daboolaa furayaasha iyo hubinta webhook-ka.

Cashuurta, celinta iyo warqadaha

Lacag bixintu waxay keentaa waajibaad code kaligiis ma xallin karo. Tani maaha talo cashuur; la tashii xisaabiyaha.

• Cashuurta iibka, VAT iyo GST. Iyada oo ku xidhan meesha adiga iyo macaamiishaadu kujirtaan, waxaa laga yaabaa inaad diiwaan gelisid, cashuur ururiso oo warbixin soo gudbiso. Stripe Tax wuxuu xisaabin karaa oo wuu ururin karaa cashuurta checkout-ka, wuxuu la socon karaa meelaha iibkaagu uu abuuri karo waajib, wuxuuna kaa caawin karaa diiwaan gelinta iyo warbixinta — laakiin mas'uuliyadda way adiga kugu sii jirtaa. Bixiyayaasha merchant of record waa doorasho kale oo qaata qayb badan oo ka mid ah.
• Celinta iyo muranka. Ka go'aan siyaasadda celinta ka hor intaadan bilaabin oo ku dhig websaydhkaaga. Muranada (chargebacks) way dhacaan; ku hay diiwaan ah waxa la iibsaday iyo waxa la gudbiyay.
• Rasiidhyada iyo invoices. Stripe wuxuu email u diri karaa rasiidhyada; ganacsatada waxaa laga yaabaa inay u baahdaan invoices sax ah.
• Kharashyada. Bixiye kasta wuxuu qaadaa kharash macaamil kasta. Hubi bogga qiimaha ee hadda bixiyaha, ha ku tiirin qiimaha maqaallada.

Habka kuu habboon app-kaaga

• Deeqaha ama dhowr alaabood oo keliya: Payment Links. Eeg how to build a nonprofit donation website.
• Dukaan leh gaari: Checkout oo leh line items iyo webhook. Eeg how to build an online store.
• SaaS ama xubinnimo: Checkout oo subscription mode ah, webhooks iyo customer portal. Eeg how to build a SaaS MVP iyo how to price a SaaS product.
• Suuq lacag u bixiya iibiyayaasha: habab kale oo ka xoogan (Stripe Connect ama wax la mid ah). Qorshee gaar ahaan.

Lacag bixinta Mythex

Lacag bixinta app-yada aad ku dhisto Mythex-ka waxay isticmaalaan akoonkaaga gaarka ah ee Stripe iyo furayaashiisa; ma jiro hal-riix "Connect Stripe" app-kaaga. Habka caadiga ah:

1. Hel furayaasha Stripe test.
2. Ku dar STRIPE_SECRET_KEY (iyo webhook secret-ka kadib) secrets-ka mashruuca — iyada oo loo marayo /secrets, settings-ka mashruuca, ama kaarka secrets-ka ee agent-ku muujiyo markii uu u baahdo furaha.
3. Weydii agent-ka Checkout adigoo isticmaalaya prompt sida kor ku taal.
4. Ku tijaabi Preview kaararka tijaabada. Publish samee ka hor intaadan diiwaan gelin webhook-ka, maadaama uu u baahan yahay URL-kaaga dadweynaha.
5. Kadib markaad u beddesho furayaasha live-ka, mar kale publish samee si app-ka live-ka uu u qaato.

Eeg Accept payments with Stripe iyo Handle webhooks in your backend dukumentiyada.

Su'aalaha