Jinsi ya Kuongeza Usajili kwa Stripe: Mipango, Majaribio, Webhooks na Malipo Yaliyoshindwa

Ili kuongeza usajili kwa Stripe, unda bidhaa yenye bei ya kujirudia kwenye Stripe Dashboard, watume wateja kwenye Stripe Checkout katika hali ya usajili kutoka kwenye seva yako, na acha webhook ikwambie app yako kila malipo yanapofanikiwa, kushindwa, kubadilika au kumalizika. Hifadhi hali ya usajili kwa mtumiaji na utoe ufikiaji kulingana nayo, si kutoka ukurasa wa mafanikio. Ongeza kitufe cha Simamia bili kinachofungua portal ya wateja ya Stripe ili watu waweze kubadilisha kadi, kubadili mipango na kughairi bila wewe kujenga skrini hizo.

Mwongozo huu unajengwa juu ya jinsi ya kuongeza malipo kwenye app yako, unaoshughulikia Checkout ya mara moja, test mode na kuanza kupokea pesa halisi. Hapa tunalenga kinachotofautiana kwenye bili ya kujirudia. Maelezo ya Stripe yanatoka kwenye nyaraka za Stripe kufikia Septemba 2026.

Kwa nini usajili ni mgumu kuliko malipo ya mara moja

Malipo ya mara moja hutokea mteja akiwa kwenye app yako. Usajili unaendelea hata baada ya mteja kuondoka: kuongezwa kila mwezi, kadi zinazoisha muda, kupandisha mpango katikati ya mzunguko, na kughairi kunakoanza mwisho wa kipindi. App yako inasikia kuhusu haya kupitia webhooks pekee. Hitilafu nyingi za usajili zinatokana na kuchukulia malipo ya kwanza kama hadithi nzima.

Chaguo zako

Kwa app nyingi, Checkout pamoja na portal ndiyo maelewano sahihi. Linganisha watoa huduma kwenye Stripe dhidi ya Paddle dhidi ya Lemon Squeezy ikiwa ushughulikiaji wa kodi unakusumbua.

Panga bei yako kwenye Stripe kwanza

Kwenye Stripe, bidhaa ni kile unachouza ("Mpango wa Pro") na bei ni jinsi unavyotoza kwa hicho ("$20 kwa mwezi", "$200 kwa mwaka"). Bidhaa moja inaweza kuwa na bei kadhaa. Amua:

• Ni viwango vipi unavyotoa na kila kimoja kinafungua nini kwenye app yako
• Kwa mwezi, kwa mwaka, au yote mawili
• Kama unatoa jaribio, na kama linahitaji kadi mapema

Unda bidhaa na bei kwenye test mode, na uhifadhi price IDs zao; app yako inazitaja. Ikiwa bado hujakamilisha bei, soma jinsi ya kupanga bei ya bidhaa ya SaaS na freemium dhidi ya jaribio la bure.

Mzunguko wa maisha wa usajili unaopaswa kushughulikia

Muhtasari wa usajili wa Stripe unaorodhesha hali ambazo usajili unaweza kuwa nazo. Zinazojali zaidi kwa ufikiaji:

Hifadhi hali kwenye rekodi yako ya mtumiaji au akaunti na uweke ufikiaji kulingana nayo. Isasishe kila webhook husika inapofika.

Matukio ya webhook ya kushughulikia

Kanuni za kishughulikiaji kutoka nyaraka za webhook za Stripe bado zinatumika: thibitisha sahihi kwa kutumia body ghafi, rudisha 2xx haraka, shughulikia matukio yanayojirudia na yasiyo na mpangilio, na tarajia majaribio tena. Mwongozo wa webhook ni nini unaeleza wazo, na mwongozo wa malipo unaorodhesha kanuni kwa kina.

Hatua kwa hatua

1. Unda bidhaa na bei kwenye test mode ya Stripe.
2. Ongeza siri: secret key, price IDs, na baadaye signing secret ya webhook. Kamwe usiziweke kwenye msimbo wa frontend.
3. Ukurasa wa bei: kitufe cha kila mpango kinaita seva yako, ambayo inaunda Checkout Session katika hali ya usajili kwa mtumiaji aliyeingia. Tuma user ID yako ili webhook iweze kulinganisha malipo na akaunti.
4. Endpoint ya webhook: thibitisha sahihi na ushughulikie matukio hapo juu, ukisasisha rekodi moja ya usajili kwa kila mtumiaji.
5. Funga vipengele kwa hali na mpango uliohifadhiwa, vilivyokaguliwa kwenye seva kwa kila kitendo kilicholindwa, si vitufe vilivyofichwa pekee.
6. Portal ya wateja: sanidi kwenye Stripe Dashboard (watu wanaweza kubadili kwenda mpango gani, kama wanaweza kughairi), kisha ongeza kitufe cha Simamia bili kinachounda session ya portal kwenye seva na kumpeleka huko.
7. Malipo yaliyoshindwa: kwenye mipangilio ya bili ya Stripe, chagua tabia ya kujaribu tena na kinachotokea baada ya jaribio la mwisho. Onyesha bango ndani ya app wakati wa past_due.
8. Jaribu mzunguko mzima wa maisha, kisha chapisha na usajili webhook ya moja kwa moja.

Maagizo ya kumpa mjenzi wako wa AI

Ongeza bili ya usajili kwa Stripe. Mipango: Starter (price ID kwenye STRIPE_PRICE_STARTER) na Pro (STRIPE_PRICE_PRO). Ukurasa wa bei unaunda Checkout Session katika hali ya usajili kwenye seva ukitumia STRIPE_SECRET_KEY, na ID ya mtumiaji aliyeingia imeambatishwa. Hifadhi Stripe customer ID, subscription ID, mpango na hali kwa mtumiaji. Usiwahi kufichua secret key kwa browser.

Ongeza POST /api/stripe/webhook. Thibitisha sahihi kwa STRIPE_WEBHOOK_SECRET ukitumia body ghafi ya ombi. Shughulikia checkout.session.completed, invoice.paid, invoice.payment_failed, customer.subscription.updated, customer.subscription.deleted na customer.subscription.trial_will_end. Rekodi IDs za matukio yaliyoshughulikiwa ili marudio yapuuzwe. Sasisha hali ya mtumiaji kutoka kwenye kitu cha usajili, si kutoka mpangilio wa matukio yanavyofika.

Funga vipengele vya Pro kwenye seva: viruhusu tu hali ikiwa active au trialing na mpango ni Pro. Onyesha bango la "malipo yameshindwa, sasisha kadi yako" hali ikiwa past_due. Ongeza kitufe cha Simamia bili kinachofungua portal ya wateja ya Stripe kwa mtumiaji huyu.

Kupandisha, kushusha na proration

Mteja anapobadili mpango, nyaraka za Stripe zinasema mabadiliko mara nyingi huunda proration: bei mpya inatumika kwa kipindi kilichobaki cha bili. Unaweza kuhakiki prorations au kuzizima. Ikiwa mipango ina muda mmoja, tarehe za bili zinabaki zilezile; kuhama kutoka kwa mwezi kwenda kwa mwaka kunahamisha tarehe ya bili hadi siku ya kubadili. Kuwaruhusu wateja wabadili mipango kwenye portal kunakuepusha kuandika mantiki hii, lakini amua kwenye mipangilio ya portal ni mabadiliko gani yanaruhusiwa.

Orodha ya ukaguzi ya majaribio

Tumia test mode ya Stripe na kadi za majaribio, kisha pitia kila hali:

• Usajili mpya unampa mtumiaji sahihi mpango sahihi
• Kufunga kichupo mara tu baada ya kulipa bado kunatoa ufikiaji (inathibitisha webhook inafanya kazi)
• Kadi iliyokataliwa wakati wa kujisajili haitoi chochote
• Kuongezwa kunakoshindwa kunaweka akaunti kwenye past_due na kuonyesha bango
• Kusasisha kadi kwenye portal kunarejesha hali ya active
• Kupandisha na kushusha mpango kunabadilisha vipengele ipasavyo
• Kughairi mwisho wa kipindi kunaweka ufikiaji hadi tarehe ya mwisho, kisha kuuondoa
• Watumiaji wa jaribio wanapata ufikiaji, wanapata kikumbusho, na wanabadilika au wanapoteza ufikiaji ipasavyo
• Kutuma tukio lilelile la webhook mara mbili hakubadilishi chochote

Majaribio ya saa ya Stripe (test clocks) yanakuruhusu kuiga muda unavyopita, ili ujaribu kuongezwa bila kusubiri mwezi. Angalia nyaraka za sasa za majaribio za Stripe kujua jinsi ya kuzitumia.

Makosa ya kawaida

• Kutoa ufikiaji kwenye ukurasa wa mafanikio. Wateja wanaweza kulipa wasifikie ukurasa huo kamwe. Tumia webhook.
• Kushughulikia malipo ya kwanza pekee. Kuongezwa, kushindwa na kughairi kunafika baadaye, kama matukio.
• Kukagua hali ya mpango upande wa frontend pekee. Mtu yeyote anaweza kuita API yako moja kwa moja.
• Mtumiaji mmoja, usajili mwingi kwa bahati mbaya. Kagua usajili uliopo kabla ya kuunda Checkout Session mpya, au wapeleke wateja waliopo kwenye portal.
• Kuondoa ufikiaji kwenye kuongezwa kwa kwanza kushindwa. Kadi zinashindwa kwa sababu za kawaida. Kipindi kifupi cha neema chenye bango wazi kinawahifadhi wateja.
• Kusahau webhook ya moja kwa moja. Endpoints za majaribio na za moja kwa moja zina signing secrets tofauti.
• Kupuuza kodi na marejesho. Amua sera yako ya marejesho na kagua wajibu wako wa kodi na mhasibu kabla ya kuzindua.

Usajili kwenye Mythex

Apps unazojenga kwenye Mythex zinatumia akaunti yako mwenyewe ya Stripe na funguo zako; hakuna muunganisho wa Stripe wa kubofya mara moja kwa app yako. Ongeza funguo zako za majaribio na price IDs kama siri za mradi, tumia maagizo kama hapo juu, na jaribu kwa kadi za majaribio za Stripe kwenye Preview. Webhooks zinahitaji URL ya umma ya app yako, kwa hiyo chapisha kabla ya kusajili endpoint kwenye Stripe, na chapisha tena baada ya kubadili funguo za moja kwa moja ili app ya moja kwa moja izichukue. Angalia Kubali malipo kwa Stripe na Shughulikia webhooks kwenye backend yako. Kwa bidhaa pana zaidi, jinsi ya kujenga SaaS MVP inaeleza unachopaswa kujenga kuzunguka bili.

Maswali