Hvernig tekur þú við greiðslum í appinu þínu: Checkout, áskriftir og webhooks

Einfaldasta leiðin til að taka við greiðslum í appinu þínu er Stripe: notaðu Payment Link ef þú þarft bara „Kaupa“-hnapp og getur afgreitt pantanir handvirkt, Stripe Checkout ef appið þarf að vita hver greiddi og bregðast við sjálfkrafa, og Checkout í áskriftarham ásamt þjónustugátt Stripe fyrir endurteknar greiðslur. Í öllum tilvikum nema þeim einfaldasta þarftu líka webhook, það er netþjónsendapunkt sem Stripe kallar á þegar greiðsla tekst, og þú ættir að prófa allt með prufulyklum og prufukortum Stripe áður en þú skiptir yfir í raunverulega lykla.

Þessi leiðbeining útskýrir hvern valkost, webhook-hlutann sem flestar kennslur sleppa, og hvað þarf að athuga áður en raunveruleg greiðsla er tekin við. Upplýsingar um Stripe eru úr skjölum Stripe sjálfs frá september 2026.

Af hverju að nota greiðsluþjónustu

Safnaðu aldrei kortanúmerum í þínum eigin eyðublöðum. Meðhöndlun hrárra kortagagna gerir þig háðan PCI DSS (öryggisstaðli kortaiðnaðarins) og er mikil áhætta. Greiðsluþjónusta eins og Stripe hýsir greiðslueyðublaðið, geymir kortið, sér um auðkenningu hjá bankanum og segir appinu þínu niðurstöðuna. Appið þitt sér aðeins „viðskiptavinur X greiddi fyrir Y“.

Þessi leiðbeining notar Stripe því það er víða notað, vel skjalfest og studd af flestum gervigreindarsmiðum fyrir öpp. Aðrar þjónustur eru til, og sumar virka sem „merchant of record“ sem tekur á sig söluskatt fyrir þig; ef skattaskil valda þér áhyggjum er það líkan þess virði að bera saman.

Þrjár leiðir til að taka við greiðslum með Stripe

Payment Links

Payment Link er greiðslusíða sem Stripe hýsir og þú býrð til í Stripe-mælaborðinu án kóða. Þú færð vefslóð sem þú getur sett á bak við hnapp í appinu þínu, deilt í tölvupósti eða sýnt sem QR-kóða. Skjöl Stripe segja að Payment Links geti selt vöru, áskrift eða tekið við styrk, og þú getur leyft viðskiptavinum að velja hvað þeir greiða eða takmarkað fjölda kaupa.

Gallinn: appið þitt veit ekki sjálfkrafa að tiltekinn innskráður notandi hafi greitt. Fyrir styrkjasíðu eða litla verslun þar sem þú afgreiðir pantanir sjálfur út frá tölvupósti frá Stripe er það í lagi. Fyrir „borgaðu til að opna Pro-eiginleikana“ er það ekki nóg.

Stripe Checkout

Checkout er greiðslusíða sem þjónninn þinn býr til eftir þörfum fyrir tiltekin kaup. Þjónninn segir Stripe hvað er keypt (og valfrjálst hvaða viðskiptavinur kaupir), Stripe skilar vefslóð og þú sendir viðskiptavininn þangað. Skjöl Stripe lýsa því að það styðji bæði einskiptis- og áskriftargreiðslur, sem síðu sem Stripe hýsir, síðu innbyggða í vefinn þinn eða innbyggt eyðublað.

Flæðið:

1. Viðskiptavinurinn smellir á Kaupa í appinu þínu.
2. Þjónninn þinn býr til Checkout-lotu með leyndarlykli þínum, þar á meðal auðkenni sem tengir hana við notandann eða pöntunina.
3. Viðskiptavinurinn er sendur til Stripe og greiðir.
4. Stripe sendir hann aftur á árangurssíðuna þína.
5. Stripe sendir atburðinn checkout.session.completed á webhook-ið þitt, og þjónninn þinn merkir pöntunina greidda eða opnar aðgang.

Skref 2 verður að gerast á netþjóninum, því það notar leyndarlykilinn þinn. Það er helsta ástæðan fyrir því að Checkout þarf bakenda.

Áskriftir

Áskriftir nota Checkout í áskriftarham með endurteknu verði sem þú setur upp í Stripe. Fyrsta greiðslan virkar eins og flæðið hér að ofan. Eftir það gerast endurnýjanir, misheppnaðar greiðslur kortsins, uppfærslur og uppsagnir með tímanum, oft þegar viðskiptavinurinn er ekki í appinu þínu, svo appið fréttir af þeim aðeins í gegnum webhook.

Fyrir að leyfa viðskiptavinum að stjórna eigin áskrift býður Stripe upp á hýsta þjónustugátt viðskiptavina. Samkvæmt skjölum Stripe geta viðskiptavinir þar uppfært greiðsluaðferðir og innheimtuupplýsingar, breytt eða sagt upp áskriftum, og skoðað og sótt reikninga. Þú stillir hana í Stripe-mælaborðinu og bætir við hnappinum „Stjórna innheimtu“ sem sendir viðskiptavininn þangað. Þannig sleppurðu við að smíða þessar skjámyndir sjálf.

Webhook: hlutinn sem þú getur ekki sleppt

Webhook er HTTP-beiðni sem Stripe sendir á netþjóninn þinn þegar eitthvað gerist. (Sjá hvað er webhook til að fá almennu hugmyndina.) Hjálparhandbók Stripe um afgreiðslu segir skýrt að þú getir ekki treyst eingöngu á árangurssíðuna til að afgreiða pantanir, því viðskiptavinur getur greitt og misst sambandið áður en síðan hleðst. Fyrir áskriftir og seinkaðar greiðsluaðferðir eru webhook nauðsynleg.

Atburðir sem vert er að meðhöndla

Reglur fyrir rétt webhook-meðhöndlun

Þessar koma beint úr skjölum Stripe um webhook, og meðhöndlun sem gervigreind býr til missir stundum af einni þeirra:

• Staðfestu undirskriftina. Hver atburður inniheldur Stripe-Signature-haus. Meðhöndlunin athugar hann með undirskriftarleyndarmáli endapunktsins (það byrjar á whsec_). Án þessa gæti hver sem er sent falska tilkynningu um „greiðsla tókst“ á netþjóninn þinn.
• Notaðu hráan meginmálsbút beiðninnar. Undirskriftarathuganir mistakast ef rammi þinn þáttar eða breytir meginmálinu fyrst.
• Svaraðu hratt með 2xx og gerðu hægari vinnu síðan. Tímamörk teljast sem bilun.
• Meðhöndlaðu tvítekningar. Stripe gæti sent sama atburð oftar en einu sinni. Skráðu auðkenni afgreiddra atburða, eða gerðu afgreiðsluna örugga í endurtekinni keyrslu.
• Ekki gera ráð fyrir röð. Stripe ábyrgist ekki að atburðir berist í sömu röð og þeir gerðust.
• Gerðu ráð fyrir endursendingum. Í raunverulegum ham reynir Stripe aftur misheppnaðar sendingar í allt að þrjá daga, svo stutt útfall tapar ekki greiðslum, en meðhöndlunin þín verður að ráða við seint komna atburði.

Webhook þurfa opið HTTPS-vistfang, svo þau virka yfirleitt aðeins þegar appið er birt (CLI Stripe getur sent atburði áfram á staðbundna vél fyrir forritara).

Fyrirmæli sem ná yfir allt flæðið

Bættu við einskiptiskaupum með Stripe Checkout fyrir „Pro-pakkann“ (verðauðkenni í STRIPE_PRICE_ID). Búðu til Checkout-lotuna á netþjóninum með STRIPE_SECRET_KEY úr leyndarmálum og settu auðkenni innskráða notandans í lotuna. Bættu við POST /api/stripe/webhook sem staðfestir Stripe-undirskriftina með STRIPE_WEBHOOK_SECRET með hráa meginmálinu, afgreiðir checkout.session.completed og merkir þann notanda sem hafa Pro-pakkann. Gakktu úr skugga um að þetta sé öruggt ef sami atburður berst tvisvar. Bættu við árangurs- og hættusíðum. Láttu leyndarlykilinn aldrei birtast í vafranum.

Fyrir áskriftir bættu við: „Notaðu áskriftarham með STRIPE_PRICE_ID. Meðhöndlaðu invoice.paid, invoice.payment_failed, customer.subscription.updated og customer.subscription.deleted. Bættu við hnappinum Stjórna innheimtu sem opnar þjónustugátt Stripe.“

Prufuhamur

Stripe er með aðskilið sandkassa- (prufu-) og raunverulegt umhverfi með sitt hvorum lyklum. Prufulyklar byrja á pk_test_, sk_test_ eða rk_test_; raunverulegir lyklar byrja á pk_live_, sk_live_ eða rk_live_. Prufufærslur hreyfa engan pening.

Gagnleg prufukort úr prófunarskjölum Stripe (hvaða gildistími sem er í framtíðinni, hvaða þriggja stafa CVC-kóði sem er):

Prófaðu að minnsta kosti:

• Vel heppnuð greiðsla opnar rétta hlutinn fyrir rétta notandann
• Hafnað kort sýnir skýr skilaboð og opnar ekkert
• Að loka vafraglugganum strax eftir greiðslu gefur samt aðgang (þetta sannar að webhook virkar, ekki bara árangurssíðan)
• Að hætta við á síðu Stripe skilar notandanum í appið án þess að neitt sé rukkað
• Fyrir áskriftir: segðu upp í þjónustugáttinni og staðfestu að aðgangur endar þegar hann á að enda

Að opna fyrir raunverulegar greiðslur

1. Virkjaðu Stripe-reikninginn með upplýsingum um fyrirtæki og bankareikning.
2. Settu raunverulega lykla í leyndarmál appsins. Stripe mælir með takmörkuðum lyklum með aðeins þeim heimildum sem samþættingin þarf, frekar en ótakmörkuðum leyndarlykli.
3. Búðu til raunverulegan webhook-endapunkt sem bendir á birta appið þitt. Hann er með sitt eigið undirskriftarleyndarmál, ólíkt prófunarleyndarmálinu, svo uppfærðu það.
4. Búðu til vörur og verð aftur í raunverulegum ham; auðkenni úr prufuham eru ekki til þar.
5. Gerðu eina raunverulega litla kaupferð og endurgreiddu hana.

Geymdu alla lykla í leyndarmálum verkefnisins, aldrei í kóða eða spjalli. Gátlistinn fyrir öryggi fjallar nánar um lykla og staðfestingu webhook.

Skattar, endurgreiðslur og pappírsvinna

Greiðslur fylgja skyldum sem kóði leysir ekki. Þetta er ekki skattaráðgjöf; leitaðu til endurskoðanda.

• Söluskattur, VSK og GST. Eftir því hvar þú og viðskiptavinir þínir eruð gætirðu þurft að skrá þig, innheimta og skila skatti. Stripe Tax getur reiknað út og innheimt skatt við greiðslu, fylgst með því hvar sala þín gæti skapað skyldu og aðstoðað við skráningar og skil, en ábyrgðin er áfram þín. Merchant-of-record þjónustur eru valkostur sem tekur á sig meira af þessu.
• Endurgreiðslur og kröfur. Ákveddu endurgreiðslustefnu fyrir opnun og settu hana á vefsíðuna þína. Kröfur (chargebacks) koma upp; haltu skrám yfir hvað var keypt og afhent.
• Kvittanir og reikningar. Stripe getur sent kvittanir í tölvupósti; fyrirtæki gætu þurft almennilega reikninga.
• Gjöld. Hver þjónusta tekur gjald af hverri færslu. Kannaðu núgildandi verðsíðu þjónustunnar frekar en að treysta tölum úr greinum.

Hvaða uppsetning hentar appinu þínu

• Framlög eða handfylli af vörum: Payment Links. Sjá hvernig býrð þú til vefsíðu fyrir styrki til góðgerðarmála.
• Verslun með körfu: Checkout með vörulínum og webhook. Sjá hvernig býrð þú til netverslun.
• SaaS eða aðild: Checkout í áskriftarham, webhook og þjónustugáttin. Sjá hvernig býrð þú til SaaS MVP og hvernig verðleggur þú SaaS-vöru.
• Markaðstorg sem greiðir seljendum: allt annað og strangara uppsetning (Stripe Connect eða svipað). Skipuleggðu það sérstaklega.

Greiðslur í Mythex

Greiðslur í öppum sem þú smíðar á Mythex nota þinn eigin Stripe-reikning og lykla; það er enginn „Tengja Stripe“-hnappur með einum smelli fyrir appið þitt. Venjulegt flæði:

1. Fáðu prufulykla Stripe.
2. Bættu STRIPE_SECRET_KEY (og webhook-leyndarmálinu síðar) við leyndarmál verkefnisins, annaðhvort í gegnum /secrets, í stillingum verkefnisins eða í leyndarmálakortinu sem smiðurinn sýnir þegar hann þarf lykil.
3. Biddu smiðinn um Checkout með fyrirmælum eins og þeim hér að ofan.
4. Prófaðu í Preview með prufukortum. Birtu áður en þú skráir webhook, því það þarf opna vefslóðina þína.
5. Eftir að skipt er yfir í raunverulega lykla skaltu birta aftur svo raunverulega appið noti þá.

Sjá Taka við greiðslum með Stripe og Meðhöndla webhook í bakendanum þínum í skjölunum.

Spurningar