ክፍያዎችን ወደ አፕዎ ማከል፦ ቼክአውትና ምዝገባዎች፣ webhooks

በአፕዎ ክፍያ ለመቀበል ቀላሉ መንገድ Stripe ነው፦ «ግዛ» ቁልፍ ብቻ ከፈለጉ እና ትዕዛዞችን በእጅ ማስተናገድ ከቻሉ Payment Link፣ አፕዎ ማን እንደከፈለ ማወቅ እና በራስ-ሰር መስራት ካለበት Stripe Checkout፣ ለተደጋጋሚ ክፍያ ደግሞ Checkoutን በsubscription mode እና የStripe customer portal። ከቀላሉ በቀር ሁሉም ሁኔታዎች webhookም ይፈልጋሉ — ክፍያ ሲሳካ Stripe የሚጠራው የአገልጋይ endpoint — እና ሁሉንም በStripe የሙከራ ቁልፎችና የሙከራ ካርዶች ፈትነው ከዚያ ወደ እውነተኛ ቁልፎች ይቀይሩ።

ይህ መመሪያ እያንዳንዱን አማራጭ፣ ብዙ ትምህርቶች የሚዘሉትን webhook ክፍል፣ እና እውነተኛ ገንዘብ ከመቀበላችሁ በፊት ምን እንደሚፈተሽ ያብራራል። የStripe ዝርዝሮች እስከ ሴፕቴምበር 2026 ድረስ ከStripe የራሱ ሰነድ የተወሰዱ ናቸው።

ክፍያ ለመቀበል የክፍያ አቅራቢ ለምን ያስፈልጋል

የካርድ ቁጥሮችን በራስዎ ቅጾች በፍጹም አይሰብስቡ። የካርድ መረጃን በቀጥታ መያዝ ወደ PCI DSS (የካርድ ኢንዱስትሪ የደህንነት ደረጃ) ውስጥ ያስገባዎታል እና ከባድ ኃላፊነት ነው። እንደ Stripe ያለ የክፍያ አቅራቢ የክፍያ ቅጹን ያስተናግዳል፣ ካርዱን ያስቀምጣል፣ የባንክ ማረጋገጫን ይይዛል፣ እና ውጤቱን ለአፕዎ ይነግራል። አፕዎ የሚያየው «ደንበኛ X ለY ከፈለ» ብቻ ነው።

ይህ መመሪያ Stripeን ይጠቀማል ምክንያቱም በሰፊው የሚጠቀም፣ በደንብ የተመዘገበና በአብዛኛዎቹ AI አፕ ገንቢዎች የሚደገፍ ነው። ሌሎች አቅራቢዎችም አሉ፣ አንዳንዶቹ እንደ «merchant of record» የሽያጭ ታክስ አያያዝን ይወስዳሉ፤ ታክስ ያሳስብዎት ከሆነ ይህንን ሞዴል ማወዳደር ተገቢ ነው።

በStripe ክፍያ ለመቀበል ሦስት መንገዶች

Payment Links

Payment Link በStripe Dashboard ውስጥ ያለ ኮድ የሚፈጥሩት በStripe የሚስተናገድ የክፍያ ገጽ ነው። በአፕዎ ቁልፍ ጀርባ ማስቀመጥ፣ በኢሜል ማጋራት ወይም እንደ QR ኮድ ማሳየት የሚችሉት URL ያገኛሉ። የStripe ሰነድ እንደሚለው Payment Links አንድ ምርት፣ ምዝገባ ወይም ልገሳ ሊሸጡ ይችላሉ፣ እና ደንበኞች ምን እንደሚከፍሉ እንዲመርጡ ወይም የግዢዎች ብዛት እንዲገደብ ማድረግ ይቻላል።

ጉዳቱ፦ አፕዎ የአንድ የገባ ተጠቃሚ መክፈሉን በራስ-ሰር አያውቅም። ለልገሳ ገጽ ወይም ከStripe ኢሜል ትዕዛዞችን በእጅ ለሚፈጽሙ ትንሽ ሱቅ ይበቃል። «ለPro ባህሪዎች ክፈሉ» ለሚል ነገር ግን አይበቃም።

Stripe Checkout

Checkout አገልጋይዎ ለተለየ ግዢ በፍላጎት የሚፈጥረው የክፍያ ገጽ ነው። አገልጋይዎ ምን እየተገዛ እንደሆነ (እና ከፈለጉ የሚገዛው ደንበኛ ማን እንደሆነ) ለStripe ይነግራል፣ Stripe URL ይመልሳል፣ እና ደንበኛውን ወደዚያ ይልካሉ። Stripe ሰነዱ እንደሚለው Checkout አንድ ጊዜ እና ምዝገባ ክፍያዎችን ይደግፋል፣ በStripe የሚስተናገድ ሙሉ ገጽ፣ በጣቢያዎ ውስጥ የተካተተ ገጽ ወይም የተካተተ ቅጽ ሊሆን ይችላል።

ፍሰቱ፦

1. ደንበኛው በአፕዎ Buy ይጫናል።
2. አገልጋይዎ የሙሉ ሚስጥር ቁልፍዎን በመጠቀም Checkout Session ይፈጥራል፣ ከተጠቃሚዎ ወይም ትዕዛዝዎ ጋር የሚያገናኝ መለያ ያካትታል።
3. ደንበኛው ወደStripe ይዛወራል እና ይከፍላል።
4. Stripe ወደ success ገጽዎ ይመልሳቸዋል።
5. Stripe የcheckout.session.completed ክስተት ወደ webhookዎ ይልካል፣ እና አገልጋይዎ ትዕዛዙን እንደተከፈለ ምልክት ያደርጋል ወይም መዳረሻ ይከፍታል።

ደረጃ 2 በአገልጋዩ ላይ መሆን አለበት፣ ምክንያቱም የሚስጥር ቁልፍዎን ይጠቀማል። Checkout የኋላ-ጫፍ የሚፈልግበት ዋናው ምክንያት ይሄ ነው።

ምዝገባዎች

ምዝገባዎች Checkoutን በsubscription mode ይጠቀማሉ ከStripe ውስጥ ካዘጋጁት ተደጋጋሚ ዋጋ ጋር። የመጀመሪያው ክፍያ ከላይ እንዳለው ፍሰት ይሠራል። ከዚያ በኋላ ማደስ፣ ያልተሳኩ ካርዶች፣ በዑደት መካከል ማሻሻያዎች እና ስረዛዎች በጊዜ ሂደት ይከሰታሉ — ብዙ ጊዜ ደንበኛው በአፕዎ ውስጥ ባይሆንም — ስለዚህ አፕዎ የሚያውቀው በwebhooks ብቻ ነው።

ደንበኞች የራሳቸውን ምዝገባ እንዲያስተዳድሩ፣ Stripe የተስተናገደ customer portal ይሰጣል። በStripe የሰነድ መሠረት ደንበኞች የክፍያ ዘዴን፣ የክፍያ ዝርዝሮችን ማዘመን፣ ምዝገባዎችን መቀየር ወይም መሰረዝ፣ እና ደረሰኞችን ማየትና ማውረድ ይችላሉ። በStripe Dashboard ውስጥ ያዋቅሩታል እና «Manage billing» ቁልፍ ያክሉ ደንበኛውን ወደዚያ የሚልክ። ይህ እነዚያን ገጾች እራስዎ ከመገንባት ያድንዎታል።

Webhooks፦ የማትዘሉት ክፍል

Webhook Stripe አንድ ነገር ሲፈጠር ወደ አገልጋይዎ የሚልከው HTTP ጥያቄ ነው። (አጠቃላይ ሀሳቡን ለማወቅ webhook ምንድን ነው ይመልከቱ።) የStripe የማሟያ መመሪያ ግልጽ ነው፦ ደንበኛው ክፍያ ፈጽሞ ያ ገጽ ከመጫኑ በፊት ግንኙነቱን ሊያጣ ስለሚችል ትዕዛዞችን በስኬት ገጹ ብቻ ማሟላት አይቻልም። ለምዝገባዎችና ለዘገዩ የክፍያ ዘዴዎች webhooks ግዴታ ናቸው።

የሚያስፈልጉ ክስተቶች

ትክክለኛ የwebhook ተቆጣጣሪ ህጎች

እነዚህ ከStripe የwebhook ሰነድ በቀጥታ የመጡ ናቸው፣ እና በAI የተፈጠሩ ተቆጣጣሪዎች አንዳንዴ አንዱን ይዘለላሉ፦

• ፊርማውን አረጋግጡ። እያንዳንዱ ክስተት Stripe-Signature ራስጌ አለው። ተቆጣጣሪዎ በendpointው የመፈረሚያ ሚስጥር ያረጋግጠዋል (በwhsec_ ይጀምራል)። ይህ ከሌለ ማንም ሰው ሐሰተኛ «ክፍያ ተሳካ» ወደ አገልጋይዎ መላክ ይችላል።
• ጥሬ የጥያቄ አካልን ተጠቀሙ። ማዕቀፍዎ አካሉን ከመተንተኑ ወይም ከመቀየሩ በፊት የፊርማ ፍተሻዎች ይወድቃሉ።
• በፍጥነት የ2xx ምላሽ ይስጡ፣ ከዚያ ቀርፋፋ ስራ ያድርጉ። ጊዜ ማለፍ እንደ ውድቀት ይቆጠራል።
• ድግግሞሾችን ያዙ። Stripe ተመሳሳይ ክስተት ከአንድ ጊዜ በላይ ሊያደርስ ይችላል። የተሰሩ የክስተት መለያዎችን ይመዝግቡ፣ ወይም ማሟላቱን ሁለት ጊዜ ቢሰራ ደህንነቱ የተጠበቀ ያድርጉ።
• ቅደም-ተከተል አትገምቱ። Stripe ክስተቶች በተከሰቱበት ቅደም-ተከተል እንደሚደርሱ አያረጋግጥም።
• ድጋሚ ሙከራዎችን ጠብቁ። በቀጥታ ሁነታ Stripe ያልተሳኩ ማድረሻዎችን እስከ ሦስት ቀናት ድረስ ይሞክራል፣ ስለዚህ አጭር መቋረጥ ክፍያዎችን አያጠፋም — ግን ተቆጣጣሪዎ ዘግይተው የሚመጡ ክስተቶችን መቋቋም አለበት።

Webhooks ይፋዊ የHTTPS አድራሻ ይፈልጋሉ፣ ስለዚህ ብዙ ጊዜ የሚሠሩት አፕዎ ከታተመ በኋላ ብቻ ነው (Stripe CLI ክስተቶችን ወደ አካባቢያዊ ማሽን ሊያስተላልፍ ይችላል፣ ለገንቢዎች)።

ሙሉውን ፍሰት የሚሸፍን ጥያቄ

ለ«Pro pack» አንድ ጊዜ ግዢ በStripe Checkout ጨምር (የዋጋ መለያ በSTRIPE_PRICE_ID)። Checkout Sessionን በአገልጋዩ ላይ ፍጠር፣ STRIPE_SECRET_KEY ከሚስጥሮች በመጠቀም፣ እና የገባውን ተጠቃሚ መለያ በsessionው ውስጥ አካት። POST /api/stripe/webhook endpoint ጨምር የStripe ፊርማውን በSTRIPE_WEBHOOK_SECRET ጥሬ የጥያቄ አካልን በመጠቀም የሚያረጋግጥ፣ checkout.session.completed የሚይዝ፣ እና ያንን ተጠቃሚ የPro pack ያለው አድርጎ የሚያመለክት። ተመሳሳይ ክስተት ሁለት ጊዜ ቢመጣ ደህንነቱ የተጠበቀ ይሁን። የተሳካና የተሰረዘ ገጾች። የሚስጥር ቁልፉን በፍጹም ለአሳሽ አታጋልጡ።

ለምዝገባዎች ጨምር፦ «በSTRIPE_PRICE_ID የምዝገባ ሁነታ ተጠቀም። invoice.paid፣ invoice.payment_failed፣ customer.subscription.updated እና customer.subscription.deleted ያዝ። ለዚህ ተጠቃሚ የStripe customer portal የሚከፍት Manage billing ቁልፍ ጨምር።»

የሙከራ ሁነታ

Stripe ለሙከራ (sandbox) እና ለእውነተኛ (live) አካባቢዎች የተለዩ ቁልፎች አሉት። የሙከራ ቁልፎች በpk_test_፣ sk_test_ ወይም rk_test_ ይጀምራሉ፤ የእውነተኛ ቁልፎች በpk_live_፣ sk_live_ ወይም rk_live_። የሙከራ ግብይቶች ገንዘብ አያንቀሳቅሱም።

ከStripe የሙከራ ሰነድ ጠቃሚ የሙከራ ካርዶች (ማንኛውም ወደፊት ጊዜ፣ ማንኛውም ባለ ሦስት አሃዝ CVC)፦

ቢያንስ ይፈትሹ፦

• ስኬታማ ክፍያ ትክክለኛውን ነገር ለትክክለኛው ተጠቃሚ ይከፍታል
• የተከለከለ ካርድ ግልጽ መልዕክት ያሳያል እና ምንም አይከፍትም
• ከከፈሉ በኋላ የአሳሽ ትሩን ወዲያው ቢዘጉም መዳረሻ ይገኛል (ይህ webhook እንደሚሠራ ያረጋግጣል፣ የስኬት ገጹ ብቻ ሳይሆን)
• በStripe ገጽ ላይ መሰረዝ ተጠቃሚውን ወደ አፕዎ ይመልሳል፤ ምንም አይከፈልም
• ለምዝገባዎች፦ በcustomer portal ይሰርዙ እና መዳረሻ መቼ እንደሚያበቃ ያረጋግጡ

ለእውነት መክፈት

1. የStripe አካውንትዎን አግብሩ በንግድና የባንክ ዝርዝሮችዎ።
2. የእውነተኛ ቁልፎችን አስገቡ በአፕዎ ሚስጥሮች ውስጥ። Stripe ከሚያስፈልጉ ፈቃዶች ብቻ ያላቸው የተገደቡ ቁልፎችን ይመክራል፣ ያልተገደበ ሚስጥራዊ ቁልፍ ከመጠቀም ይልቅ።
3. የእውነተኛ webhook endpoint ፍጠሩ ወደ የታተመ አፕዎ ያመለክታል። የራሱ የመፈረሚያ ሚስጥር አለው፣ ከሙከራው የተለየ — አዘምኑት።
4. ምርቶችንና ዋጋዎችን በእውነተኛ ሁነታ እንደገና ፍጠሩ፤ የሙከራ ሁነታ መለያዎች እዚያ የሉም።
5. አንድ እውነተኛ ትንሽ ግዢ ፈጽሙና መልሱ።

ሁሉንም ቁልፎች በፕሮጀክትዎ ሚስጥሮች ውስጥ ያስቀምጡ፣ በኮድ ወይም በውይይት አይደለም። የደህንነት ዝርዝራችን ስለ ቁልፎችና webhook ፊርማ ማረጋገጥ የበለጠ ይላል።

ግብር፣ ተመላሽ ገንዘብና ወረቀት ስራ

ክፍያዎች ኮድ የማይፈታቸው ግዴታዎች ያመጣሉ። ይህ የግብር ምክር አይደለም፤ ከሒሳብ ባለሙያ ጋር ያረጋግጡ።

• የሽያጭ ታክስ፣ VAT እና GST። በእርስዎና በደንበኞችዎ ቦታ ላይ በመመስረት መመዝገብ፣ ታክስ መሰብሰብና ማስገባት ሊያስፈልግዎ ይችላል። Stripe Tax በCheckout ታክስ ማስላትና መሰብሰብ፣ ሽያጮችዎ ግዴታ ሊፈጥሩ የሚችሉበትን መከታተል፣ እና ለመመዝገብና ለማስገባት መርዳት ይችላል — ግን ኃላፊነቱ በእርስዎ ላይ ይቀራል። Merchant-of-record አቅራቢዎች ተጨማሪውን ይወስዳሉ።
• ተመላሽና ክርክሮች። ከመጀመርዎ በፊት የተመላሽ ፖሊሲዎን ይወስኑ እና በጣቢያዎ ላይ ያስቀምጡ። ክርክሮች (chargebacks) ይከሰታሉ፤ ምን እንደተገዛና እንደተሰጠ መዝገብ ይያዙ።
• ደረሰኞችና ኢንቮይስ። Stripe ደረሰኞችን በኢሜል ሊልክ ይችላል፤ ንግዶች ትክክለኛ ኢንቮይስ ሊፈልጉ ይችላሉ።
• ክፍያዎች። ማንኛውም አቅራቢ በግብይት ያስከፍላል። የአቅራቢውን የአሁን የዋጋ ገጽ ይመልከቱ፣ በጽሑፎች ውስጥ ባሉ ቁጥሮች ከመተማመን ይልቅ።

የትኛው ቅንብር ለአፕዎ ይስማማል

• ልገሳዎች ወይም ጥቂት ምርቶች፦ Payment Links። የበጎ አድራጎት ልገሳ ድር ጣቢያ እንዴት መገንባት ይመልከቱ።
• ቅርጫት ያለው ሱቅ፦ Checkout ከመስመር ዕቃዎች እና webhook ጋር። የኦንላይን ሱቅ እንዴት መገንባት ይመልከቱ።
• SaaS ወይም አባልነቶች፦ Checkout በምዝገባ ሁነታ፣ webhooks እና customer portal። SaaS MVP እንዴት መገንባት እና SaaS ምርትን እንዴት ዋጋ መስጠት ይመልከቱ።
• ለሻጮች የሚከፍል ገበያ ቦታ፦ የተለየ፣ ይበልጥ ቁጥጥር ያለው ቅንብር (Stripe Connect ወይም ተመሳሳይ)። ለብቻው ያቅዱ።

ክፍያዎችን በMythex መጨመር

በMythex የገነቧቸው አፖች ክፍያ የሚቀበሉት የራስዎን Stripe አካውንትና ቁልፎች በመጠቀም ነው፤ ለአፕዎ የ«Connect Stripe» አንድ ጠቅታ የለም። የተለመደው ፍሰት፦

1. የStripe የሙከራ ቁልፎችን ያግኙ።
2. STRIPE_SECRET_KEY (እና በኋላ የwebhook ሚስጥሩን) ወደ የፕሮጀክት ሚስጥሮች ያክሉ — በ/secrets፣ በፕሮጀክት ቅንብሮች ወይም ወኪሉ ቁልፍ ሲፈልግ በሚያሳየው የሚስጥር ካርድ በኩል።
3. ለወኪሉ ከላይ እንዳለው ዓይነት ጥያቄ በመጠቀም Checkout ይጠይቁ።
4. በPreview በሙከራ ካርዶች ይሞክሩ። webhookውን ከመመዝገብዎ በፊት ያትሙ፣ ምክንያቱም የይፋዊ URLዎን ይፈልጋል።
5. ወደ እውነተኛ ቁልፎች ከቀየሩ በኋላ እንደገና ያትሙ፣ የቀጥታ አፑ እንዲወስዳቸው።

በStripe ክፍያዎችን ተቀበሉ እና በጀርባዎ webhooksን ያዙ በሰነዱ ውስጥ ይመልከቱ።

ጥያቄዎች