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.

Anza somo shirikishiSoma maelezo ya somo

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.

Faili za mazoezi

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

Start hereFaili za mazoezi

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.

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.

Stripe: unda Payment Link

Faili za hatua hii

Start hereFaili za mazoezi

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)

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.

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.

Stripe: majaribio

Faili za hatua hii

Start hereFaili za mazoezi

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.

    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.

    Faili za hatua hii

    Start hereFaili za mazoezi

    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.

      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.

      Faili za hatua hii

      Start hereFaili za mazoezi

      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.

      Somo hili lilikufaa?

      Bonyeza kupenda au mshirikishe mtu anayeweza kufaidika nalo.

      Endelea kujifunza

      Angalia masomo mengine