Isomo rigufi · Kinyarwanda

Uko wakwakira ubwishyu ku rubuga rwawe

Kora Payment Link y'igerageza, uyihuze n'urupapuro watanzwe wemeze ubwishyu muri konti yawe ya serivisi utubatse seriveri y'ubwishyu.

Tangira isomo rikorwamo imyitozoSoma inyandiko z’isomo

Ibi bigenewe nde?

Abashaka buto y'ubwishyu ku rubuga. Inzira y'ibanze ikoresha urupapuro rw'ubwishyu rwakirwa na serivisi n'umufasha wo kwandika kode ku ihuza; kode ya seriveri, gutegura ububiko bw'amakuru no kwandika webhook ni ibikorwa byimbitse by'ubushake.

Mbere yo gutangira

Konti yawe ya Stripe yujuje ibisabwa ifite ahantu h'igerageza na urupapuro watanzwe. Umufasha wo kwandika kode ashobora gushyiraho ihuza rusange ry'igerageza. Inzira y'ibanze ntikeneye Supabase, urufunguzo rw'ibanga rwa API muri mushakisha cyangwa seriveri yihariye.

Igihe kigereranyijwe: 35–53 min

Igihe kigereranyijwe ukoresheje dosiye zo gutangiriraho zatanzwe, konti n’ibikoresho bikenewe byamaze gutegurwa. Gutegura, gutegereza gushyira urubuga kuri interineti, imeli cyangwa DNS bishobora gufata ikindi gihe. Kuzuza ibisabwa bya konti, kuyifungurira ibikorwa no gutangiza ubucuruzi nyabwo biri hanze y'uyu mwitozo. Nta mafaranga nyayo cyangwa amakuru y'ikarita nyayo bikoreshwa.

Ibyo uziga

  • Kora ihuza ryo kwishyura ryo mu igerageza rigaragajwe neza.
  • Huza ugerageze buto y'ubwishyu y'urubuga.
  • Emeza uko kwishyura no gusesa bihagaze koko muri serivisi aho kwizera urupapuro rwo kugarukaho.

Dosiye z'imyitozo

Intambwe 1

Hitamo intego y'ubwishyu mu igerageza

Hera ku rupapuro rwo kwishyura rwakirwa na serivisi aho kwiyakiririra amakuru y'amakarita.

Koresha ibidukikije byawe bya Stripe by'igerageza n'igicuruzwa n'igiciro by'impimbano. Fungura urupapuro watanzwe uri kumwe n'umufasha uhitemo icyo buto y'ubwishyu igomba kuvuga.

Gumana uyu mwitozo mu buryo bw'igerageza. Kuba umushyitsi afunguye aderesi y'intsinzi ntibyemeza ko hari ubwishyu bwabaye.

Urugero rufatika

Mu rugero, igicuruzwa gishobora kuba “Sample digital workshop” gifite igiciro cy’igerageza rimwe cya USD 5. Buto igomba kuvuga ko ifungura kwishyura kw’igerageza; nta rupapuro cyangwa iri somo bisezeranya gutanga icyo gicuruzwa byikora.

Koresha urupapuro rusange watanzwe ku mwitozo w'ibanze wa Payment Link yakirwa na serivisi. Mfasha gukora igicuruzwa n'igiciro bimwe by'igerageza muri Stripe sandbox yanjye, ushyire gusa URL yabyo rusange yo kwishyura y'igerageza mu igenamiterere ry'urupapuro. Ntushyireho inzira y'ububiko bw'amakuru na webhook y'ubushake cyangwa ngo ukoreshe amabanga ya konti nyakuri. Mfasha gutangaza gusa urupapuro rw'umwitozo rugamijwe no kwemeza ubwishyu bw'igerageza muri Dashboard ya serivisi. Urupapuro rwo kugarukaho si gihamya y'ubwishyu.

Stripe: kora Payment Link · Stripe: kugerageza

Dosiye z'iyi ntambwe

Start hereDosiye z'imyitozo

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)

Akira ubwishyu bw'igerageza ukoresheje checkout yakiriwe na serivisi

Tangirira kuri paji y'igerageza yakiriwe n'utanga serivisi, usobanure neza aho wemeza intsinzi.

Payment Link yakiriwe na serivisi yemerera utanga serivisi kwakira amakuru yo kwishyura, utashyize imyanya yo kwinjiza amakuru y'ikarita muri paji yawe. Uyu mwitozo ukoresha gusa ibidukikije bya sandbox/test bya Stripe n'agaciro k'amakarita y'igerageza.

Urubuga rufungura checkout, naho seriveri ikakira events z'ubwishyu zashyizweho umukono kandi ikandika inyemezabwishyu. Paji yo kugarukaho ni iyo kuyobora gusa: buri wese ashobora gufungura URL, bityo kuyigeraho ntibyemeza ubwishyu.

Urugero rusobanuye

Gufungura success.html utaziguye ntibigomba gukora inyemezabwishyu. Session yemejwe ko yishyuwe iva kuri Payment Link y'igerageza yatunganyijwe ishobora gukora imwe n'ubwo umukiriya atagaruka ku rubuga rwawe.

Stripe: nyuma yo kwishyura ukoresheje Payment Link · Stripe: kugerageza

Extra implementation exercise

Umukoresha asuye /success.html?paid=true. Ese sisitemu yawe igomba kumuha igicuruzwa cyishyurwa?

Erekana igisubizo gisobanuye

Oya. Query parameter igenzurwa n'umushyitsi. Koresha event yemejwe y'utanga serivisi cyangwa igenzura rya serivisi rikorerwa kuri seriveri kandi rihujwe n'ubwishyu bwateganyijwe.

  • Yanga URLs zigenzurwa n'usaba nk'igihamya cy'ubwishyu.
  • Isaba uko ubwishyu buhagaze byemejwe n'utanga serivisi.

Intambwe 2

Kora uhuze ihuza ry'igerageza

Koresha ikibaho cya serivisi ureke umufasha ahindure urupapuro.

Kora igicuruzwa n'igiciro byo kwishyura rimwe na Payment Link by'igerageza muri konti yawe. Fungura urupapuro rwabyo rusange rwo kwishyura utinjiye, hanyuma uhe umufasha iyo URL y'igerageza ayihuze mu rupapuro rusange watanzwe.

Genzura igicuruzwa, umubare w'amafaranga, ifaranga n'ibidukikije by'igerageza mbere yo gukomeza. URL rusange yo kwishyura y'igerageza yonyine ni yo yemerwa muri uru rupapuro; nta rufunguzo rw'ibanga rwo gusinya cyangwa rwa API rukenewe ku ihuza ry'ibanze.

Urugero rufatika

Igenamiterere ryatsinze rifungura urupapuro rusange rw’ubwishyu bw’igerageza bw’igicuruzwa utinjiye muri konti. Urupapuro rw’igenamiterere rya Stripe cyangwa test_REPLACE itahinduwe si ihuriro rikoreshwa ryo kwishyura.

Stripe: kora Payment Link

Dosiye z'iyi ntambwe

Start hereDosiye z'imyitozo

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)

Tunganya checkout y'igerageza itandukanye

Tandukanya URLs rusange za checkout n'amabanga y'uburenganzira ya seriveri n'aya webhook.

Kurikiza START-HERE.txt kugira ngo ukore Payment Link y'igerageza y'ubwishyu bw'inshuro imwe, imbonerahamwe ya database n'aho webhook yoherezwa. Shyiraho dependency ya Stripe ifite verisiyo yagenwe muri uyu mushinga wo kwigiraho kandi ubike lockfile yakozwe na yo.

Muri config.js shyiramo gusa URL rusange ya checkout y'igerageza. Environment values za seriveri zirimo test secret key, endpoint signing secret, Payment Link ID iteganyijwe na private database key. Iyi code yanga ku bushake amakuru y'uburenganzira bw'ibikorwa nyabyo.

Ku ruhererekane rwuzuye rwo kuri mudasobwa yawe, fungura run-locally.txt: tegura igenamiterere ry'ibanga rya seriveri muri dosiye .env iri mu bubiko shingiro bw'umushinga, hanze ya public/ kandi idakurikiranwa na Git; huza gusa umushinga wo kwitoza kandi utangize proxy ya Netlify functions. server-env.example.txt itondeka amazina ya variables idafite amabanga nyayo. Gufungura HTML gusa ntibishobora gukoresha seriveri.

Urugero rusobanuye

Webhook signing secret yemeza endpoint wemera ko events zayo ziturukaho. Si Payment Link rusange kandi si API key; gukoporora ibanga ritari ryo bituma igenzura ry'umukono ryanga.

Node.js: imimerere y'uburyo busohotse bushyigikiwe

Extra implementation exercise

Ni iki muri ibi kijya muri public/config.js: URL ya checkout y'igerageza cyangwa ibanga ryo gusinya rya whsec?

Erekana igisubizo gisobanuye

URL rusange ya checkout yonyine ni yo ijya aho. Gumana ibanga rya webhook n'ama secret keys ya serivisi/database muri environment variables za seriveri.

  • Agumisha amabanga yo gusinya na API kuri seriveri.
  • Akoresha gusa aho checkout rusange yerekeza muri code ya mushakisha.

Intambwe 3

Uzuza ubwishyu bumwe bw'igerageza bwa serivisi

Koresha amabwiriza yemewe y'igerageza usuzume igisubizo muri konti.

Kurikiza amabwiriza ya Stripe y'igerageza ahujwe uri mu bidukikije by'igerageza gusa. Uzuza ubwishyu bw'igerageza bwo kujugunywa, hanyuma ushake ubwishyu cyangwa session nyayo yabwo muri konti yawe.

Emeza aho umubare w'amafaranga uteganyijwe, ifaranga n'uko bwishyuwe. Inzira y'impapuro yarangiye ishobora gutandukana n'uko ubwishyu burangira koko, cyane cyane ku buryo bwishyurwa nyuma.

Urugero rufatika

«Inzira yo kwishyura yarangiye» na «ubwishyu bwemejwe ko bwishyuwe» si buri gihe ibyo kwibonera bimwe.

Stripe: kugerageza

Dosiye z'iyi ntambwe

Start hereDosiye z'imyitozo

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)

    Genzura event kandi wandike ko byishyuwe rimwe gusa

    Emeza inkomoko ya payload itahinduwe mbere yo gusobanura JSON yayo.

    Handler iha SDK yemewe bytes z'ubusabe bw'umwimerere zitahinduwe na Stripe-Signature. Gusesengura cyangwa guhindura imiterere ya JSON mbere yo kugenzura umukono bishobora guhindura izo bytes kandi bigatuma igenzura ryanga.

    Yemera gusa ubwoko bwa event buteganyijwe, test mode, payment_link ihuye n'iteganyijwe na payment_status=paid. Uburyo bwo kwishyura butinda bushobora kurangiza checkout mbere y'uko ubwishyu bugenda neza, bityo kurangiza checkout byonyine ntibihagije. session_id yihariye ituma kongera kwinjiza inyemezabwishyu bitagira ingaruka mbi.

    Event IDs ebyiri zitandukanye zishobora kuvuga checkout session imwe: urugero, kurangiza checkout bigakurikirwa no gutsinda k'ubwishyu butunganywa nyuma. Primary key ya session_id hamwe na on_conflict=session_id na resolution=ignore-duplicates bituma kwinjiza inyemezabwishyu burundu bishobora gusubirwamo. Kwandika muri database kwanze ntiguhishwa: hasubizwa 503 kugira ngo event ishobore kongera kugeragezwa.

    Urugero rusobanuye

    Session imwe yishyuwe itanzwe kabiri ikomeza kugira agaciro kamwe ka primary key. Kunanirwa kwa database gusubiza 503 kugira ngo kohereza kongere kugeragezwa, aho kwemeza kwakira event kandi igisubizo cyayo cyatakaye.

    Stripe: kugenzura umukono wa webhook no kongera kugerageza

    Extra implementation exercise

    Kuki checkout.session.completed ifite payment_status=unpaid itarafatwa nk'ibyo batumije byishyuwe?

    Erekana igisubizo gisobanuye

    Uburyo bumwe bwo kwishyura bwemezwa nyuma. Tegereza ko byemezwa ko byishyuwe, harimo async success event aho bikenewe, mbere yo kwandika inyemezabwishyu y'ibyishyuwe.

    • Atandukanya kurangira kwa checkout no kwemezwa ko ubwishyu bwakiriwe.
    • Ategereza icyemezo gikwiye cy'ubwishyu.

    Intambwe 4

    Gerageza gusesa no kujya ku rupapuro rwo kugarukaho bitaziguye

    Genzura ko umushyitsi adashobora guhimba igisubizo cy'ubwishyu bwo kunyura mu mpapuro.

    Tangira ubundi bwishyu bw’igerageza ubuvemo utarangije, cyangwa ukoreshe inzira yo kubuhagarika serivisi itanga koko. Ku ruhande, fungura success.html watanzwe utaziguye. Gereranya byombi n’inyandiko z’ubwishyu bw’igerageza muri konti ya serivisi.

    Ubwishyu watangiye ukabuvamo bushobora kuba butuzuye cyangwa bugifunguye aho kuba bwanditseho “canceled”. Nta gikorwa muri ibi gikwiye kwitwa kugura gushya kwishyuwe. Urupapuro rw’ibanze ntirutanga igicuruzwa byikora.

    Urugero rufatika

    Gufungura success.html cyangwa kongera paid=true kuri URL yayo ntibirema ubwishyu buhuye bwishyuwe muri Stripe. Kugaruka ku rubuga no kwemeza ubwishyu ni ibikorwa bitandukanye.

    Dosiye z'iyi ntambwe

    Start hereDosiye z'imyitozo

    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)

      Kurikirana ubwishyu bumwe bw'igerageza kuva butangiye kugeza burangiye

      Huza checkout session, event yashyizweho umukono n'inyemezabwishyu yabitswe.

      Koresha gusa agaciro k'amakarita y'igerageza kemewe muri checkout yawe ya sandbox. Shaka session yavuyemo n'uko webhook yatanzwe muri konti yawe, hanyuma usuzume imbonerahamwe ya payment_receipts idafunguriwe rubanda mu mushinga wo kwigiraho.

      Genzura umubare w'amafaranga n'ifaranga ugereranyije na session. Ongera wohereze event imwe yemewe kandi wemeze ko hakiri umurongo umwe. Gerageza ubusabe butashyizweho umukono no gusura paji y'intsinzi utaziguye; nta na kimwe kigomba gukora inyandiko y'ubwishyu.

      Urugero rusobanuye

      Igisubizo cya webhook cya 200 cyemeza ko handler hari icyo yemeje ko yakiriye. Reba inyemezabwishyu na session bihuye aho kwibwira ko events zose zihuye n'igicuruzwa cyateganyijwe.

      Extra implementation exercise

      Webhook isubije 200 kuri event idafitanye isano n'ibyateganyijwe. Ese bivuga ko inyemezabwishyu igomba kuba ihari?

      Erekana igisubizo gisobanuye

      Oya. Handler yemeza kwakira events zirengagizwa itakoze inyemezabwishyu. Session y'igerageza yishyuwe ihuye n'ibiteganyijwe yonyine ni yo igomba gukora inyandiko iteganyijwe.

      • Asobanukirwa events zirengagizwa ku bushake.
      • Ahuza ibyabitswe na session yishyuwe yihariye.

      Intambwe 5

      Hererekanya inzira y'ibanze y'ubwishyu

      Soza ihuza rifasha utavuze ko ufite sisitemu y'ubucuruzi yuzuye.

      Subiramo amagenzura ya buto y'urubuga n'ubwishyu bwo mu igerageza nyuma yo gukosora. Bika urupapuro n'ihuriro by'umwitozo n'inyandiko yakuwemo amakuru y'ibanga y'amagerageza yatsinze n'ayaseswe cyangwa atarangiye.

      Mbere yo kugurisha nyabyo, emeza ubucuruzi na konti byawe byujuje ibisabwa, igiciro n'ifaranga, amabwiriza n'uburyo bw'imikorere. Uburenganzira bwikora, ibikorwa byashyizweho umukono no kugarura ububiko bw'amakuru biri mu nyigisho zimbitse z'ubushake zikurikira.

      Urugero rufatika

      Buto ikora yo kwishyura ku rupapuro rwakirwa na serivisi ni igisubizo gito cyemewe; si gihamya ko seriveri yo gutanga igicuruzwa itarubakwa ibaho.

      Dosiye z'iyi ntambwe

      Start hereDosiye z'imyitozo

      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)

      Umukoro wawe: gerageza gusubirana nyuma y'ikibazo nta kwishyuza nyabyo

      Uburyo bwo kwishyura bugomba gukira ikibazo cyo kwandika muri database kitakozwe.

      Mu mushinga ushobora gusibwa nyuma, koresha by'agateganyo imiterere ya database itari yo kandi wongere wohereze event yawe yemewe y'ubwishyu bw'igerageza. Reba igisubizo kitari icy'intsinzi kandi urebe ko nta nyemezabwishyu nshya. Subizaho imiterere ikwiye wongere wohereze, hanyuma wemeze ko hari umurongo umwe gusa uhuye na byo.

      Sobanura ibisigaye mbere yo kugurisha nyabyo: imiterere ya konti n'ubucuruzi byemewe, igiciro/ifaranga n'amasezerano bikwiye, gutanga ibyaguzwe mu buryo burambye, guhuza inyandiko z'ubwishyu, gusubiza amafaranga no kugenzura imikorere. Uyu mwitozo wandika gusa inyemezabwishyu z'igerageza.

      Urugero rusobanuye

      Iyo kubika byanze ariko endpoint ikavuga “success”, kongera kugerageza byikora bishobora guhagarara mbere y'uko inyandiko yawe ibaho. Kugaragaza kunanirwa uko kuri ni igice cy'uburyo bwo kwakira ubwishyu bwizewe.

      Ubuyobozi bwuzuye bw'urugero buri muri reference/assignment-walkthrough.txt. Gereranya intambwe zabwo n'ibyo wakoze; uzuza inyandiko y'igerageza ukurikije ibyo wabonye mu mushinga wawe.

      Extra implementation exercise

      Erekana kubika kwanze no gusubirana byagenze neza bitabyara inyandiko zisubirwamo.

      Erekana igisubizo gisobanuye

      Shyiraho dependencies mu mushinga utandukanye wo kwigiraho ukoresheje npm install; ibi bikora package-lock.json, ugumana n'uwo mushinga. Koresha gusa Payment Link y'igerageza n'amakuru y'uburenganzira ya sk_test_. Ihuriro rusange si ibanga ryo gusinya rya webhook.

      Shaka session yawe y'igerageza yishyuwe ihuye n'ibiteganyijwe, uko webhook yayo yashyizweho umukono yatanzwe, n'inyemezabwishyu yihariye ifite session_id, amount na currency bimwe. Ongera utange iyo event: primary key hamwe n'ihitamo rya ignore-duplicates bigomba gusiga inyemezabwishyu imwe. Ubusabe butashyizweho umukono cyangwa gusura paji y'intsinzi utaziguye ntibigomba gukora n'imwe.

      Mu myitozo yo kunanirwa, hindura by'agateganyo SUPABASE_URL gusa mu bidukikije byo kuri mudasobwa/seriveri bishobora gusibwa nyuma, uyerekeze ahantu hatari ho h'igerageza. Ongera utange event imwe yemewe kandi urebe kunanirwa gushobora kongera kugeragezwa. Subizaho imiterere, wongere utange event kandi wemeze inyemezabwishyu imwe ibitswe burundu. Ntuzigere uhindura imiterere y'ibikorwa nyabyo cyangwa ngo ugerageze ukoresheje ikarita nyayo.

      • Kunanirwa kubika ntikwemeza ko gutunganya byagenze neza.
      • Gusubirana bikora inyemezabwishyu imwe; nta makuru y'ubwishyu nyabwo cyangwa amafaranga nyayo bikoreshwa.

      Iri somo ryagufashije?

      Kanda ko urikunze, cyangwa urisangize uwo ryafasha.

      Komeza kwiga

      Reba andi masomo