
Somo fupi · Kiswahili
Jinsi ya kupokea malipo kwenye tovuti yako
Unda Payment Link ya majaribio, iunganishe na ukurasa uliotolewa na uhakiki malipo kwenye akaunti yako ya mtoa huduma bila kujenga mfumo wa nyuma wa malipo.
Somo hili ni la nani?
Kwa watu wanaotaka kitufe cha malipo kwenye tovuti. Njia ya msingi hutumia ukurasa wa malipo uliopangishwa na msaidizi wa programu kwa kiungo; msimbo wa seva, usanidi wa hifadhidata na programu ya webhook ni kazi za juu za hiari.
Kabla ya kuanza
Akaunti yako mwenyewe ya Stripe inayostahili yenye mazingira ya sandbox au majaribio na ukurasa uliotolewa. Msaidizi wa programu anaweza kusanidi kiungo cha umma cha majaribio. Njia ya msingi haihitaji Supabase, ufunguo wa siri wa API kwenye kivinjari au seva yako mwenyewe.
Muda unaokadiriwa: 35–53 dakika
Makadirio yanatumia faili za kuanzia zilizotolewa, huku akaunti na zana zinazohitajika zikiwa tayari. Usanidi, foleni za uchapishaji na kusubiri barua pepe au DNS huhitaji muda zaidi. Kustahili kwa akaunti, kuwashwa na kuzindua biashara halisi ni nje ya zoezi hili. Hakuna pesa wala taarifa halisi za kadi zinazotumika.
Utakachojifunza
- Unda kiungo cha malipo cha mazingira ya majaribio kilichotambulishwa wazi.
- Unganisha na ujaribu kitufe cha malipo cha tovuti.
- Hakiki hali halisi za kulipwa na kughairiwa kwa mtoa huduma badala ya kuamini ukurasa wa kurudi.
Hatua 1
Chagua lengo la malipo la sandbox
Anza na ukurasa wa malipo uliopangishwa badala ya kukusanya taarifa za kadi mwenyewe.
Tumia mazingira yako ya Stripe ya majaribio na bidhaa na bei za kubuni. Fungua ukurasa uliotolewa pamoja na msaidizi wako na uamue kitufe cha malipo kinapaswa kueleza nini.
Weka zoezi hili kwenye hali ya majaribio. Mgeni kufungua anwani ya mafanikio hakuthibitishi kwamba malipo yoyote yalifanyika.
Mfano halisi
Kwa mfano, bidhaa inaweza kuwa “Sample digital workshop” yenye bei ya jaribio ya mara moja ya USD 5. Kitufe kiseme kinafungua malipo ya jaribio; ukurasa wala somo haviahidi utoaji wa bidhaa wa moja kwa moja.
Tumia ukurasa wa umma uliotolewa kwa zoezi la msingi la Payment Link iliyopangishwa. Nisaidie kuunda bidhaa na bei moja ya majaribio kwenye sandbox yangu ya Stripe na kuweka URL yake ya umma ya majaribio ya malipo pekee kwenye usanidi wa ukurasa. Usisanidi njia ya hiari ya hifadhidata na webhook au kutumia taarifa za akaunti za malipo halisi. Saidia kuchapisha ukurasa wa mazoezi uliokusudiwa tu na kuhakiki malipo ya majaribio kwenye Dashboard ya mtoa huduma. Ukurasa wa kurudi si ushahidi wa malipo.Stripe: unda Payment Link · Stripe: majaribio
Faili za hatua hii
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
Inspect individual files (optional)
How it works (optional)
Pokea malipo ya majaribio kwa ukurasa wa huduma
Anza na ukurasa wa majaribio unaohostiwa na mtoa huduma pamoja na mpaka wazi wa kuthibitisha mafanikio.
Payment Link inayohostiwa humruhusu mtoa huduma kukusanya taarifa za malipo bila kuweka sehemu za kadi kwenye ukurasa wako. Zoezi hutumia sandbox/mazingira ya majaribio ya Stripe na thamani za kadi za majaribio pekee.
Tovuti hufungua checkout, hatua ya kulipa, wakati seva hupokea matukio yaliyosainiwa na kurekodi risiti. Ukurasa wa kurudi ni urambazaji tu: yeyote anaweza kufungua URL, hivyo hauwezi kuthibitisha malipo.
Mfano uliotatuliwa
Kufungua success.html moja kwa moja kusiunde risiti. Session iliyolipwa iliyothibitishwa ya Payment Link iliyowekwa inaweza kuunda risiti hata mteja asiporudi kwenye tovuti.
Stripe: baada ya malipo ya Payment Link · Stripe: majaribio
Extra implementation exercise
Mtumiaji anafungua /success.html?paid=true. Je, mfumo umpe bidhaa ya kulipiwa?
Onyesha mfano wa suluhisho
Hapana. Parameter ya URL inadhibitiwa na mgeni. Tumia tukio lililothibitishwa la huduma au ukaguzi wa huduma kwenye seva unaohusishwa na muamala unaokusudiwa.
- Hakubali URL inayodhibitiwa na mwombaji kuwa ushahidi wa malipo.
- Anahitaji hali ya malipo iliyothibitishwa kwa huduma.
Kosa linalofanywa mara nyingi
Kufungua bidhaa kwa sababu ukurasa wa mafanikio umefunguliwa.
Hatua 2
Unda na uunganishe kiungo cha majaribio
Tumia dashibodi ya mtoa huduma na umruhusu msaidizi ahariri ukurasa.
Unda bidhaa na bei ya mara moja ya majaribio na Payment Link kwenye akaunti yako. Fungua ukurasa wake wa umma wa malipo bila kuingia kwenye akaunti, kisha mpe msaidizi URL hiyo ya majaribio aiunganishe kwenye ukurasa wa umma uliotolewa.
Kagua bidhaa, kiasi, sarafu na mazingira ya majaribio kabla ya kuendelea. URL ya umma ya malipo ya majaribio pekee iwe kwenye ukurasa huu; hakuna ufunguo binafsi wa kutia saini au API unaohitajika kwa kiungo cha msingi.
Mfano halisi
Usanidi uliofaulu unafungua checkout ya umma ya jaribio bila kuingia. Ukurasa wa mipangilio ya akaunti ya Stripe au test_REPLACE isiyobadilishwa si kiungo kinachotumika cha kulipa.
Jaribu mwenyewe
Kitufe cha tovuti kinafungua ukurasa uliokusudiwa wa malipo wa sandbox wenye bidhaa na bei sahihi?
Jadili jibu lako na msaidizi wa somo
Onyesha mfano wa suluhisho
Ukaguzi wa mfano: Kiungo kinafungua checkout ya jaribio ya “Sample digital workshop”, USD 5, bila kuomba akaunti yangu ya Stripe. Kiungo hicho tu kimewekwa ukurasa; hakuna ufunguo wa API au siri ya webhook inayohitajika kwa njia hii rahisi.
- Analinganisha checkout bila kuingia na bidhaa, kiasi, sarafu na hali ya jaribio vinavyokusudiwa.
- Anatumia Payment Link ya umma ya jaribio pekee katika mipangilio ya ukurasa.
Faili za hatua hii
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
How it works (optional)
Sanidi checkout tofauti ya majaribio
Tenganisha URL za umma za malipo na funguo za seva na siri za webhook.
Fuata START-HERE.txt kuunda Payment Link ya malipo ya mara moja ya majaribio, jedwali na lengo la webhook. Sakinisha toleo maalumu la Stripe katika mradi huu na uhifadhi lockfile iliyotengenezwa.
Weka URL ya umma ya checkout ya majaribio pekee kwenye config.js. Mazingira ya seva yana ufunguo wa siri wa majaribio, siri ya kusaini endpoint, Payment Link ID inayotarajiwa na ufunguo wa siri wa hifadhidata. Msimbo hukataa funguo za malipo halisi kimakusudi.
Kwa mfuatano wote wa ndani, fungua run-locally.txt: andaa mazingira ya siri kwenye mzizi, unganisha mradi wa mazoezi pekee na uanzishe wakala wa functions wa Netlify. server-env.example.txt huorodhesha majina ya vigezo bila siri halisi. Kufungua HTML pekee hakuwezi kuendesha seva.
Mfano uliotatuliwa
Siri ya kusaini webhook huthibitisha matukio ya endpoint unayokubali. Si Payment Link ya umma wala ufunguo wa API; kunakili siri isiyo sahihi husababisha sahihi kushindwa.
Node.js: hali ya usaidizi wa matoleo
Extra implementation exercise
Kipi kinawekwa kwenye public/config.js: URL ya checkout ya majaribio au siri ya sahihi whsec?
Onyesha mfano wa suluhisho
URL ya umma pekee iwe humo. Siri ya webhook na funguo za siri za huduma/hifadhidata ziwe kwenye vigezo vya mazingira ya seva.
- Anahifadhi siri za sahihi/API kwenye seva.
- Anatumia lengo la umma la checkout pekee kwenye msimbo wa kivinjari.
Kosa linalofanywa mara nyingi
Kuchanganya siri ya endpoint ya kupeleka maombi ya ndani na siri ya endpoint iliyohostiwa.
Hatua 3
Kamilisha malipo moja ya majaribio kwa mtoa huduma
Tumia maelekezo rasmi ya majaribio na ukague matokeo ya akaunti.
Fuata mwongozo uliounganishwa wa majaribio wa Stripe ndani ya sandbox pekee. Kamilisha malipo ya majaribio ya kutupwa, kisha utafute malipo au kipindi chake halisi kwenye akaunti yako.
Hakiki kiasi kinachotarajiwa, sarafu na hali ya kulipwa huko. Mtiririko wa ukurasa uliokamilika bado unaweza kutofautiana na hali ya mwisho ya malipo, hasa kwa njia zinazokamilisha malipo baadaye.
Mfano halisi
“Utaratibu wa malipo umekamilika” na “malipo yamethibitishwa kulipwa” si uchunguzi uleule kila mara.
Jaribu mwenyewe
Rekodi ya mtoa huduma iliripoti nini kweli kuhusu malipo yako ya majaribio?
Jadili jibu lako na msaidizi wa somo
Onyesha mfano wa suluhisho
Matokeo ya mfano: Malipo yanayolingana yamewekwa paid kwa USD 5, kulingana na bei. Mtoa huduma akisema processing au unpaid, ningeandika hivyo badala ya kusema yamelipwa kwa sababu ukurasa umemaliza tu.
- Anapata malipo ya jaribio yanayolingana na hali yake halisi ya kulipwa kwenye akaunti.
- Analinganisha kiasi na sarafu zilizorekodiwa na bei ya jaribio iliyochaguliwa.
Faili za hatua hii
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
Inspect individual files (optional)
How it works (optional)
Hakikisha tukio na urekodi hali ya kulipwa mara moja
Thibitisha uhalali wa data asili kabla ya kutafsiri JSON yake.
Handler hupeleka baiti asili zisizobadilishwa za ombi na Stripe-Signature kwa SDK rasmi. Kusoma au kupanga JSON upya kabla ya kuhakiki sahihi kunaweza kubadili baiti na kuharibu uthibitishaji.
Inakubali aina za matukio zinazotarajiwa, hali ya majaribio, payment_link inayolingana na payment_status=paid pekee. Njia zenye ucheleweshaji zinaweza kukamilisha checkout kabla malipo kufaulu, hivyo checkout kukamilika haitoshi. session_id ya kipekee hufanya kuingiza risiti tena kusiunde madhara.
ID mbili za matukio tofauti zinaweza kueleza checkout session ileile: kwa mfano checkout kukamilika kisha malipo ya baadaye kufaulu. Primary key ya session_id pamoja na on_conflict=session_id na resolution=ignore-duplicates hufanya kuingiza risiti kwa kudumu kurudiwe salama. Kosa la hifadhidata halifichwi: hurudisha 503 ili tukio liweze kutumwa tena.
Mfano uliotatuliwa
Session ileile iliyolipwa ikitumwa mara mbili bado ina thamani moja ya primary key. Hifadhidata ikishindwa, 503 huruhusu kurudia badala ya kukiri tukio ambalo matokeo yake yamepotea.
Stripe: uthibitishaji wa sahihi za webhook na kurudia
Extra implementation exercise
Kwa nini checkout.session.completed yenye payment_status=unpaid haiwezi bado kuchukuliwa kuwa oda iliyolipwa?
Onyesha mfano wa suluhisho
Baadhi ya njia huthibitisha baadaye. Subiri hali iliyothibitishwa ya paid, ikijumuisha tukio la async success inapofaa, kabla ya kurekodi risiti iliyolipwa.
- Anatenganisha kukamilika kwa checkout na hali ya malipo yaliyokamilika.
- Anasubiri uthibitisho unaofaa wa kulipwa.
Kosa linalofanywa mara nyingi
Kuweka kila checkout iliyokamilika kuwa imelipwa bila kujali payment_status.
Hatua 4
Jaribu kughairi na ukurasa wa kurudi wa moja kwa moja
Kagua kwamba mgeni hawezi kutengeneza matokeo ya kulipwa kwa urambazaji.
Anza checkout tofauti ya jaribio na uiondokee bila kumaliza, au tumia njia ya kughairi inayotolewa kweli. Kando yake fungua success.html moja kwa moja. Linganisha vyote na rekodi za jaribio kwa mtoa huduma.
Checkout iliyoachwa inaweza kuwa incomplete au open badala ya lebo halisi “canceled”. Hakuna tendo kati ya hayo liitwe ununuzi mpya uliolipwa. Ukurasa rahisi hautoi bidhaa kiotomatiki.
Mfano halisi
Kufungua success.html au kuongeza paid=true kwenye URL hakutengenezi malipo yanayolingana yaliyolipwa Stripe. Kurudi tovuti na kuthibitisha malipo ni mambo tofauti.
Jaribu mwenyewe
Kughairi na ziara ya moja kwa moja ya ukurasa wa kurudi vilithibitisha nini, na havikuthibitisha nini?
Jadili jibu lako na msaidizi wa somo
Onyesha mfano wa suluhisho
Katika ukaguzi huu wa mfano, checkout ya pili iliachwa bila kukamilika na haikuwa na malipo mapya paid. Kufungua success.html kulionyesha ujumbe wa kurudi tu. Hakuna tendo linalothibitisha ununuzi, na ukurasa hautoi ufikiaji wa bidhaa kiotomatiki.
- Anatofautisha checkout iliyoghairiwa au isiyokamilika na malipo yaliyolipwa yanayolingana.
- Anatambua kufungua ukurasa wa kurudi pekee hakuthibitishi malipo wala kutoa bidhaa.
Faili za hatua hii
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
Inspect individual files (optional)
How it works (optional)
Fuatilia malipo moja ya majaribio mwanzo hadi mwisho
Linganisha checkout session, tukio lililosainiwa na risiti iliyohifadhiwa.
Tumia thamani rasmi za kadi za majaribio pekee katika sandbox. Pata session na webhook kwenye akaunti, kisha ukague jedwali la siri la payment_receipts kwenye mradi wa mazoezi.
Hakikisha kiasi na sarafu vinalingana na session. Tuma tena tukio lilelile halali na uhakikishe rekodi moja inabaki. Jaribu ombi lisilosainiwa na kufungua ukurasa wa mafanikio moja kwa moja; hakuna linalopaswa kuunda rekodi ya malipo.
Mfano uliotatuliwa
Jibu 200 la webhook huthibitisha handler imekiri kitu. Kagua risiti na session zinazolingana badala ya kudhani matukio yote ni ya bidhaa inayokusudiwa.
Extra implementation exercise
Webhook inarudisha 200 kwa tukio lisilohusika. Je, maana yake risiti inapaswa kuwepo?
Onyesha mfano wa suluhisho
Hapana. Handler hukiri matukio yanayopuuzwa bila risiti. Session ya majaribio iliyolipwa inayolingana pekee iunde rekodi inayokusudiwa.
- Anaelewa matukio yanayopuuzwa kimakusudi.
- Analinganisha hali iliyohifadhiwa na session mahsusi iliyolipwa.
Kosa linalofanywa mara nyingi
Kutarajia kila webhook iliyokiriwa iwakilishe oda mpya.
Hatua 5
Kabidhi njia ya msingi ya malipo
Kamilisha kiungo chenye manufaa bila kudai mfumo kamili wa biashara.
Rudia ukaguzi wa kitufe cha tovuti na malipo ya sandbox baada ya marekebisho yoyote. Hifadhi ukurasa na kiungo cha mazoezi na rekodi iliyofichwa taarifa nyeti ya majaribio yaliyofaulu na yaliyoghairiwa au kutokamilika.
Kabla ya mauzo halisi, thibitisha biashara na akaunti yako vinastahili, bei na sarafu, masharti na utaratibu wa uendeshaji. Ufikiaji wa kiotomatiki, matukio yaliyotiwa saini na urejeshaji wa hifadhidata ni sehemu ya nyenzo za juu za hiari hapa chini.
Mfano halisi
Kitufe cha malipo yaliyopangishwa kinachofanya kazi ni matokeo madogo halali; si ushahidi wa mfumo wa nyuma wa utoaji ambao haujajengwa.
Jaribu mwenyewe
Vifaa vya kuanzia
Faili na maudhui ya majaribio yametolewa. Uthibitishaji halisi bado unahitaji akaunti, barua au kikoa chako kama masharti yanavyoeleza. Unaweza kuchunguza ndani ya kompyuta; andika hatua za mtandaoni ambazo hujafanya kama hazijajaribiwa.
Toa njia ya majaribio na matokeo halisi ya sandbox, pamoja na chochote kinachohitajika kabla ya uzinduzi halisi.
Unachopaswa kuandaa Kiungo na ukurasa wako wa malipo ya majaribio na uchunguzi halisi wa malipo na kughairi wa sandbox; hakuna malipo halisi.
Jadili jibu lako na msaidizi wa somo
Onyesha mfano wa suluhisho
Makabidhiano ya mfano: Ukurasa unafungua checkout ya USD 5; jaribio moja linalolingana ni paid kwa USD 5; lililoachwa halijalipwa; kufungua ukurasa wa kurudi hakubadili rekodi. Hakuna fedha halisi au utoaji wa bidhaa uliojaribiwa. Kabla ya uzinduzi bado nahitaji akaunti inayostahiki, masharti halisi na utoaji uliothibitishwa.
- Anatoa njia ya jaribio ya umma iliyosanidiwa na matokeo ya malipo pamoja na yasiyokamilika/yaliyoghairiwa.
- Anaeleza kutoza halisi na kutoa bidhaa kiotomatiki haviko kwenye jaribio rahisi lililokamilika.
Faili za hatua hii
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
Inspect individual files (optional)
How it works (optional)
Kazi yako: fanya mazoezi ya kurejesha bila makato halisi
Mtiririko wa malipo lazima uweze kurudia uandishi wa hifadhidata uliokosekana.
Katika mradi wa mazoezi, tumia kwa muda mpangilio usio sahihi wa hifadhidata na utume tena tukio lako halali la malipo ya majaribio. Ona jibu lisilofaulu na kutokuwepo kwa risiti mpya. Rejesha usanidi na utume tena, kisha uhakikishe rekodi moja tu inayolingana.
Eleza kinachobaki kabla ya kuuza kweli: akaunti/biashara inayoungwa mkono, bei/sarafu na masharti sahihi, utoaji wa bidhaa unaotegemewa, kulinganisha rekodi, kurejesha pesa na ufuatiliaji wa uendeshaji. Warsha hurekodi risiti za majaribio pekee.
Mfano uliotatuliwa
Uhifadhi ukishindwa lakini endpoint ikasema “mafanikio”, kurudia kiotomatiki kunaweza kusimama kabla rekodi yako haijaundwa. Kushindwa kwa uaminifu ni sehemu ya kushughulikia malipo kwa kutegemewa.
Maelezo kamili ya hatua za suluhisho yanapatikana katika reference/assignment-walkthrough.txt. Linganisha hatua zake na matokeo yako; jaza rekodi ya majaribio kwa ulichokiona katika mradi wako mwenyewe.
Extra implementation exercise
Onyesha jaribio la uhifadhi lililoshindwa na kurejesha kulikofaulu bila kurudia risiti.
Onyesha mfano wa suluhisho
Sakinisha dependencies katika mradi tofauti kwa npm install; hutengeneza package-lock.json ambayo uhifadhi pamoja na mradi. Tumia Payment Link ya majaribio na funguo za sk_test_ tu. Kiungo cha umma si siri ya sahihi ya webhook.
Pata session yako ya majaribio iliyolipwa inayolingana, webhook yake iliyosainiwa na risiti ya siri yenye session_id, kiasi na sarafu zilezile. Tuma tukio tena: primary key na chaguo la ignore-duplicates vibakishe risiti moja. Ombi lisilosainiwa au ukurasa wa mafanikio wa moja kwa moja usiunde yoyote.
Kwa jaribio la kushindwa, badilisha SUPABASE_URL kwa muda kwenye mazingira ya ndani/seva ya mazoezi tu iwe lengo lisilo sahihi. Tuma tukio lilelile halali na uone kosa linaloweza kurudiwa. Rejesha mpangilio, tuma tena na uhakikishe risiti moja ya kudumu. Usibadili uzalishaji wala kujaribu kwa kadi halisi kamwe.
- Kushindwa kuhifadhi hakukiri kuwa kushughulikia kumefaulu.
- Kurejesha huunda risiti moja; hakuna taarifa wala pesa halisi za malipo zinazotumika.
Kosa linalofanywa mara nyingi
Kuita mfumo wa kurekodi risiti kuwa mfumo kamili wa biashara wa uzalishaji.
Somo hili lilikufaa?
Bonyeza kupenda au mshirikishe mtu anayeweza kufaidika nalo.
Endelea kujifunza
- Jinsi ya kutengeneza tovuti yako binafsi ya kwanza
- Jinsi ya kuchapisha tovuti yako kutoka GitHub
- Jinsi ya kuunganisha kikoa chako na tovuti yako
- Jinsi ya kusanidi barua pepe kwenye kikoa chako
- Jinsi ya kufanya tovuti yako itumike vizuri kwenye simu
- Jinsi ya kufanya picha za tovuti zipakie haraka zaidi
- Jinsi ya kupokea maoni ya tovuti kwenye kikasha chako
- Jinsi ya kuongeza usajili wa barua pepe kwenye tovuti yako
- Jinsi ya kutuma barua pepe za kiotomatiki kutoka tovuti yako
- Jinsi ya kuhifadhi ujumbe wa fomu kwenye hifadhidata
- Jinsi ya kuwaruhusu watu kuingia kwenye tovuti yako
- Jinsi ya kuweka ukurasa kuwa wa siri
- Jinsi ya kuwaruhusu watumiaji kuhariri taarifa za wasifu wao
- Jinsi ya kuwaruhusu watumiaji kupakia picha
- Jinsi ya kuweka funguo za API nje ya msimbo wa kivinjari
- Jinsi ya kuonyesha data kutoka API ya huduma nyingine kwenye tovuti yako
- Jinsi ya kuongeza chatbot ya AI kwenye tovuti yako
- Jinsi ya kufanya chatbot ijibu kwa maudhui yako
- Jinsi ya kuongeza blogu kwenye tovuti yako
- Jinsi ya kuongeza utafutaji kwenye tovuti yako
- Jinsi ya kuongeza lugha nyingine kwenye tovuti yako
- Jinsi ya kusaidia Google ipate tovuti yako
- Jinsi ya kurekebisha hakiki ya tovuti yako unaposhiriki kiungo
- Jinsi ya kupima ziara na vitendo vyenye manufaa kwenye tovuti yako
- Jinsi ya kuwawezesha wageni kuweka miadi
- Jinsi ya kuhakiki mabadiliko ya tovuti kabla ya kuchapisha
- Jinsi ya kutengua uchapishaji wa tovuti ulioharibika
- Jinsi ya kuhifadhi nakala rudufu na kurejesha data ya tovuti yako
- Jinsi ya kupata na kurekebisha makosa kwenye tovuti yako ya umma