Reference Operations

API፣ webhook እና ውህደቶች

የAPI ቁልፎች ለ Staff Logins፣ API ምን እንደሚሰራ፣ Webhooks እና ዝግጅቶቻቸው፣የክፍያ ጭነት፣ፊርማ እና ዳግም ሙከራዎች፣እና ዝግጁ የሆኑ ውህደቶች፡Poster፣Toast፣SmartKasa፣ Make እና Zapier።

Quick read

የታደሰበት: 19 ኖቬምበር 2026

ኤፒአይ እና ውህደቶች

API ቁልፎች በAPI እና ውህደቶች

መቼቶች → API እና ውህደቶች ሶስት ትሮች አሏቸው፡- API ቁልፎች፣ የድር መንጠቆዎች እና ውህደቶች።

የAPI እና API ቁልፎች በእያንዳንዱ እቅድ ላይ ነፃ ናቸው፣ Free Forever ተካተዋል፤ ምንም የAPI ተጨማሪ የለም። በAPI በኩል የተሰጡ ማህተሞች እንደማንኛውም Card Operation ናቸው፣ ስለዚህ የእቅዱ Card Operationዎች ሲያልቅ ይቆማሉ። Webhooks የሚከፈልበት ክፍል ናቸው, ከታች ይመልከቱ.

API ተጨማሪ ወጪ አለው?

ቁ.API እና API ቁልፎች በእያንዳንዱ እቅድ ላይ ነፃ ናቸው፣ Free Forever ተካትቷል። በእሱ በኩል የተሰጡ ማህተሞች እንደማንኛውም Card Operationዎች ናቸው።

API በFree Forever ላይ መጠቀም እችላለሁ?

አዎ። የእቅዱ Card Operationዎች ሲያልቅ፣ ማህተሞች በAPI በኩል እንደማንኛውም ይቆማሉ።

የAPI መቼቶች የት አሉ?

በቅንብሮች → API እና ውህደቶች፣ ከሶስት ትሮች ጋር — API ቁልፎች፣ Webhooks እና ውህደቶች።

የኤፒአይ ቁልፎች

ለሰራተኞች መግቢያ የAPI ቁልፍ ይፍጠሩ

የAPI ቁልፍ በAPI ቁልፎች ስር ተፈጥሯል → ለአንድ የሰራተኛ መግቢያ የAPI ቁልፍ ያክሉ። የሰራተኞች መግቢያ ቢበዛ አንድ API ቁልፍ አለው፣ እና ጠፍቷል የሰራተኛ መግቢያ መምረጥ አይቻልም። ለመምረጥ ምንም የሰራተኛ መግቢያ ከሌለ፣ የAPI ቁልፍ መስኮት እዚያው ለመፍጠር ያቀርባል። አዲስ የሰራተኞች መግቢያ ነፃ Staff Seat ያስፈልገዋል፣ እና ሙሉ እቅድ ላይ መስኮቱ መቀመጫ ለመጨመር ወይም በምትኩ እቅድ ለመምረጥ ያቀርባል።

በAPI ቁልፍ የሚደረገው እያንዳንዱ ጥሪ እንደ Staff Login ይሰራል፡ ወደዚያ የሰራተኛ መግቢያ ንግድ ብቻ ይደርሳል፣ ለእሱ የተመረጠውን የቴምብር ካርድ በራስ-ሰር በማተም ማህተም ያደርጋል፣ ማህተሞቹም እንደ Staff Login’s Card Operations ይቆጠራሉ።

ቁልፉ በማንኛውም ጊዜ ከAPI ቁልፎች ዝርዝር ውስጥ እንደገና ሊታይ እና ሊገለበጥ ይችላል። እንዲሁም እንደ QR ኮድ፣ ወደ ተርሚናል ለመቃኘት እና በ Staff Login ስም ሊታተም ይችላል።

የAPI ቁልፍ እንዴት መፍጠር እችላለሁ?

በቅንብሮች → API እና ውህደት → API ቁልፎች ውስጥ የAPI ቁልፍ አክል የሚለውን ይምረጡ እና የሰራተኛ መግቢያን ይምረጡ። እያንዳንዱ የሰራተኞች መግቢያ ቢበዛ አንድ API ቁልፍ አለው።

API ቁልፌን አጣሁ። አዲስ ያስፈልገኛል?

ቁልፉ በማንኛውም ጊዜ ከAPI ቁልፎች ዝርዝር ወይም እንደ QR ኮድ ሊታይ እና ሊገለበጥ ይችላል።

የትኛውን የቴምብር ካርድ API የሚጠራው ማህተም ነው?

በራስ ሰር ማህተም ስር ለቁልፍ የሰራተኞች መግቢያ የተመረጠው። ማህተሞቹ እንደ Staff Login’s Card Operations ይቆጠራሉ።

ለአዲስ ቁልፍ የሰራተኛ መግቢያ ለምን መምረጥ አልችልም?

የጠፋ የስታፍ መግቢያ መምረጥ አይቻልም፣ እና አስቀድሞ ቁልፍ ያለው የሰራተኛ መግቢያ ሁለተኛ ማግኘት አይችልም። ምንም መምረጥ ከሌለ መስኮቱ የሰራተኞች መግቢያን ለመፍጠር ያቀርባል።

የAPI ቁልፍ መስራት ሲያቆም

የAPI ቁልፍ የአገልግሎት ጊዜው አያበቃም። ሥራውን የሚያቆመው ሲታደስ ወይም ሲሰረዝ ወይም የስታፍ መግቢያ ሲጠፋ ወይም ሲሰረዝ ብቻ ነው። ለሰራተኞች መግቢያ አዲስ የይለፍ ቃል ወይም መግቢያ አይነካውም.

  • እንደገና ማመንጨት ለሰራተኞች መግቢያ አዲስ API ቁልፍ ይሰጣል። አሮጌው በአንድ ጊዜ መሥራት ያቆማል.
  • Delete ቁልፉን በአንድ ጊዜ ያቆማል። የ Staff Login እራሱ በ7Stamp Scanner ውስጥ መስራቱን ይቀጥላል እና በኋላ አዲስ ቁልፍ ማግኘት ይችላል።
  • የስታፍ መግቢያን ማጥፋት ቁልፉን ይጠብቃል፡ የሰራተኞች መግቢያ ተመልሶ ሲበራ ያው ቁልፍ እንደገና ይሰራል።

የAPI ቁልፍ ጊዜው ያልፍበታል?

አይደለም መስራት የሚያቆመው ሲታደስ ወይም ሲሰረዝ ወይም የስታፍ መግቢያ ሲጠፋ ወይም ሲሰረዝ ብቻ ነው።

የ Staff Login የይለፍ ቃል ቀይሬያለሁ። አዲስ API ቁልፍ ያስፈልገኛል?

አዲስ የይለፍ ቃል ወይም መግቢያ በAPI ቁልፍ ላይ ተጽዕኖ አያሳርፍም።

የ Staff Loginን መልሼ ቀይሬያለሁ። የድሮው API ቁልፍ ይሰራል?

አዎ። የስታፍ መግቢያን ማጥፋት ቁልፉን ያቆያል፣ እና ተመሳሳዩ ቁልፍ ከተመለሰ በኋላ እንደገና ይሰራል።

API የሚያደርገው

በAPI በኩል ስርዓቱ የሚከተሉትን ማድረግ ይችላል፡-

  • የቴምብር ካርድ እንደ ማገናኛ ወይም QR መስጠት;
  • ማህተሞችን መጨመር;
  • ማህተሞቹን፣ ግቦችን እና ቫውቸሮችን የያዘ ካርድ አንብብ።
  • ቫውቸር በቀጥታ ወደ ካርድ መስጠት;
  • ቫውቸር በቫውቸር ኮድ ማስመለስ፤
  • ለደንበኛ መልእክት ይላኩ።

API እንደ CRM መታወቂያ፣ ስልክ ወይም ኢሜይል ያለ እንደ external_id የተላከ የደንበኛ ካርድ በንግድ በራሱ መለያ ያገኛል። መለያው በካርዱ ላይ ተከማችቶ ስለእሱ በእያንዳንዱ Webhook ተመልሶ ይመጣል። API የቢዝነስ ደንበኞችን የሚዘረዝር ጥሪ የለውም፡ አጠቃላይ የደንበኛ መሰረት የሚወጣው በአስተዳዳሪው ወደ ውጭ በመላክ ብቻ ነው።

ከAPI ቁልፍ ይልቅ መተግበሪያ በ Staff Login መግቢያ እና ይለፍ ቃል መግባት ይችላል - ገንዘብ ተቀባይ ለሚገባበት መሳሪያ። የAPI ቁልፍ ያለ ክትትል ለሚሰራ መሳሪያ ይስማማል። Webhooks በአስተዳዳሪው ውስጥ ብቻ ይታከላሉ; API ለክስተቶች ለመመዝገብ ወይም ለመዘርዘር ምንም ጥሪ የለውም።

API ምንም አይነት የጥያቄ መጠን ገደብ አላስቀመጠም ጥሪዎች በቁጥር ወይም በድግግሞሽ አይታገሡም እና ተመሳሳዩ ካርድ ወዲያውኑ እንደገና መቃኘት ይችላል። በእሱ ማተምን የሚገድበው የዕቅዱ Card Operations ነው።

ማህተሞችን ከራሳችን CRM ወይም POS ማከል እንችላለን?

አዎ፣ በAPI በኩል። የቴምብር ካርዶችን ይሰጣል፣ ማህተሞችን ይጨምራል፣ ካርዶችን ያነባል እና ቫውቸሮችን ያስወጣል። ስርዓትዎ ስለክስተቶች እንዲነገር፣የWebhooks & Events ተጨማሪ የሚያስፈልገው Webhook ያክሉ።

ውሂብ ወደ ውጭ መላክ እንችላለን?

በAPI በኩል ካርዶችን በራስዎ መለያ ያንብቡ እና Webhooks እንደሚከሰቱ ክስተቶችን ይልካሉ። API የሁሉም ደንበኞች ዝርዝር የለውም - አጠቃላይ የደንበኛ መሰረት በአስተዳዳሪው ወደ ውጭ ይወጣል።

API የደንበኛ ካርድ እንዴት ያገኛል?

በራስዎ ለዪ — የCRM መታወቂያ፣ ስልክ ወይም ኢሜል — እንደ external_id ተልኳል። በካርዱ ላይ ተከማችቶ ስለእሱ በእያንዳንዱ Webhook ተመልሶ ይመጣል።

በAPI በኩል ለWebhooks መመዝገብ እችላለሁ?

አይ የድር መንጠቆዎች የሚታከሉት በአስተዳዳሪው ውስጥ ብቻ ነው።

API ተመን ገደብ አለው?

አይ ጥሪዎች በቁጥር ወይም በድግግሞሽ አይታገሡም እና ተመሳሳዩ ካርድ ወዲያውኑ እንደገና መቃኘት ይችላል። ማህተም ማድረግ በእቅዱ Card Operations ብቻ የተገደበ ነው።

የኤፒአይ ማጣቀሻ

የAPI ማጣቀሻ ይፋዊ ነው እና መግባት አያስፈልገውም፡ Swagger በ https://api.7loc.com/cards-api/docs, እና OpenAPI ፋይሉ በ https://api.7loc.com/cards-api/openapi.json. ጥሪዎች ወደ https://api.7loc.com/cards-api ይሄዳሉ እና API ቁልፍ ወይም የሰራተኛ መግቢያ ያስፈልጋቸዋል።

የWhite Label ንግድ በአስተዳዳሪው ውስጥ ወደ API ማጣቀሻ ምንም አይነት አገናኝ አያይም። የእሱ API ቁልፎች እና Webhooks ተመሳሳይ ይሰራሉ.

የAPI ሰነድ የት አለ?

Swagger በ https://api.7loc.com/cards-api/docs, ይፋዊ፣ ምንም መግባት አያስፈልግም። የOpenAPI ፋይል https://api.7loc.com/cards-api/openapi.json. ላይ ነው።

ለAPI ጥሪዎች መነሻ አድራሻ ምንድነው?

https://api.7loc.com/cards-api. ጥሪዎች የAPI ቁልፍ ወይም የሰራተኞች መግቢያ ያስፈልጋቸዋል።

የእኛ የWhite Label አስተዳዳሪ ምንም የAPI ሰነዶች አገናኝ የለውም። API ለእኛ ይሰራል?

አዎ። የWhite Label ንግድ ወደ ማመሳከሪያው ምንም አይነት አገናኝ አያይም፣ ነገር ግን የAPI ቁልፎቹ እና Webhooks ተመሳሳይ ይሰራሉ።

የድር መንጠቆዎች

በAPI እና ውህደቶች ውስጥ የድር መንጠቆዎች

የድር መንጠቆ በAPI እና ውህደቶች → Webhooks → የዌብ መንጠቆን አክል፣ ክስተቶቹን በሚቀበለው URL ታክሏል። በ7Stamp ለስታምፕ ካርድ ዝግጅቶች ዌብሆክ ተፈጥሯል። አንድ ንግድ ብዙ የድር መንጠቆዎችን ማከል ይችላል፣ እያንዳንዱም የራሱ URL አለው።

Webhooks በሚከፈልባቸው ዕቅዶች ላይ ብቻ የሚቀርበው የWebhooks & Events ተጨማሪ፣ በወር $19 ያስፈልጋቸዋል። ለመግዛት የመጀመሪያውን Webhook ማከል; ያለ እሱ ዌብ መንጠቆ ሊፈጠር ወይም ተመልሶ ሊበራ አይችልም። አንድ ተጨማሪ አንድ Webhook እንደበራ ያቆያል፡ ተጨማሪ ሊታከል ይችላል፣ ነገር ግን እያንዳንዱ የደንበኝነት ምዝገባው የክፍያ መጠየቂያ ማሻሻያ ሁሉንም ያጠፋል።

የድር መንጠቆዎች የድር መንጠቆው ከተጨመረበት ጊዜ ጀምሮ እንደሚከሰቱ ክስተቶችን ይልካሉ። ቀደምት ክስተቶች አልተላኩም።

Webhooks ነፃ ናቸው?

ቁጥር፡ በሚከፈልባቸው ዕቅዶች ብቻ የሚቀርበው የWebhooks & Events ተጨማሪ፣ በወር $19 ያስፈልጋቸዋል። API ራሱ ነፃ ነው።

ሁለተኛ Webhook ጨምሬ ጠፍቷል። ለምን፧

አንድ የWebhooks & Events ተጨማሪ አንድ Webhook እንደበራ ያቆያል። የደንበኝነት ምዝገባው እያንዳንዱ የክፍያ መጠየቂያ ዝማኔ ሁሉንም ያጠፋል ነገር ግን በጣም ጥንታዊውን ብቻ ነው.

አዲስ Webhook ያለፉ ክስተቶችን ይልካል?

አይ፡ ክስተቶች የሚላኩት Webhook ከታከለበት ጊዜ ጀምሮ ነው።

Webhook ክስተቶች

Webhook በ event_type ውስጥ የተሰየሙ አስራ አምስት የቴምብር ካርድ ክስተቶችን ይቀበላል፡ SCAN፣ DELIVERY_INSERT፣ RECEIPT_SCAN፣ CARD_JOINED፣ REWARD_EARNED፣ VOUCHER_ISSUED፣ VOUCHER_PACK፣ ADMIN_VOUCHER_ISSUE፣ VOUCHER_REDEEMED፣ LOTTERY_WIN፣ CARD_CAMPAIGN፣ BIRTHDAY_GREETING፣ AUTO_MESSAGE_VOUCHER፣ CARD_ADDED_TO_WALLET እና CARD_REMOVED_FROM_WALLET። የመጨረሻዎቹ ሁለቱ ማለፊያው ወደ wallet ሲጨመር ወይም ከእሱ ሲወገድ፣ ከwallet፣ Apple ወይም Google ጋር ሲሆኑ ይመጣሉ።

ምንም ማህተም የማይጨምር ቅኝት ለምሳሌ ከቴምብር ዋጋ በታች ግዢ አሁንም SCAN ከዜሮ ማህተሞች ጋር ይልካል። በተሽከርካሪ ላይ የተሸለመው ሽልማት በአንድ LOTTERY_WIN የሚታወቀው መንኮራኩሩ በሚሽከረከርበት ጊዜ እንጂ በREWARD_EARNED ወይም VOUCHER_ISSUED አይደለም። ለመሽከርከር የሚጠብቅ መንኮራኩር እስካሁን ምንም አይልክም።

የደንበኛ ግምገማዎች የቴምብር ካርድ ክስተቶች አይደሉም። እያንዳንዱ አዲስ ግምገማ በዌብ መንጠቆ ገጽ ላይ ከዕቃዎቻቸው ጋር ምልክት ላደረጉት የዌብ መንጠቆዎች review እና የድርጊት created ክስተትን ይልካል። እዚህ የተጨመረው Webhook ለስታምፕ ካርድ ዝግጅቶች ብቻ ተዋቅሯል፣ ስለዚህ ግምገማዎች አንዴ ምልክት ካደረጉ በኋላ ግምገማዎችን ያገኛል።

ስካን ምንም ማህተም በማይጨምርበት ጊዜ Webhook ይላካል?

አዎ። ምንም ማህተም የማይጨምር ቅኝት ለምሳሌ ከቴምብር ዋጋ በታች ግዢ አሁንም SCAN ን ከዜሮ ማህተሞች ጋር ይልካል።

የትኛው ክስተት ደንበኛ በተሽከርካሪው ላይ እንዳሸነፈ የሚነግረኝ?

LOTTERY_WIN፣ መንኮራኩሩ ሲፈተል አንድ ጊዜ ተልኳል። ለመሽከርከር የሚጠብቅ መንኮራኩር እስካሁን ምንም አይልክም።

አንድ ደንበኛ ካርዱን ከኪስ ቦርሳቸው ሲያነሱት ማወቅ እችላለሁ?

አዎ። ማለፊያውን ወደ ኪስ ቦርሳ ማከል እና ማስወገድ CARD_ADDED_TO_WALLET እና CARD_REMOVED_FROM_WALLET ከኪስ ቦርሳ፣ አፕል ወይም ጉግል ጋር ይላኩ።

አዲስ የደንበኛ ግምገማዎችን በWebhook እንዴት ማግኘት እችላለሁ?

የWebhook ገጹን ይክፈቱ እና ከዕቃዎቹ መካከል ግምገማዎችን ምልክት ያድርጉ። እያንዳንዱ አዲስ ግምገማ ከህጋዊ አካል ግምገማ እና እርምጃ ጋር ይመጣል። በAPI ስር የተጨመረው Webhook እና ውህደቶች የቴምብር ካርድ ዝግጅቶችን እስከዚያ ድረስ ብቻ ያገኛል።

እያንዳንዱ ክስተት ሲላክ

ክስተትመቼ ተልኳል።
SCANየ Staff Login ካርዱን ይቃኛል፡ በ7Stamp Scanner፣ በAPI ወይም POS እንደ Toast። በ7Stamp Scanner ውስጥ የተወገዱ ማህተሞች SCAN አሉታዊ stamps_added ናቸው።
DELIVERY_INSERTአንድ ደንበኛ ቴምብሮችን የሚሰጥ የቴምብር ኮድ ይከፍታል - QR፣ ማገናኛ፣ ኮዱ ራሱ ወይም በAPI በኩል የተደረገ ግብዣ።
RECEIPT_SCANአንድ ደንበኛ በቢዝነስ ቻትቦት ውስጥ የፊስካል ደረሰኝ ይቃኛል እና ማህተም ተደርጎበታል፤ amount ጠቅላላ ደረሰኝ ነው።
CARD_JOINEDምንም ይሁን ምን ደንበኛ አዲስ የቴምብር ካርድ ያገኛል፣ እርስዎ ካለፉበት external_id ጋር
REWARD_EARNEDቅኝት የAward ግብ ላይ ይደርሳል
VOUCHER_ISSUEDቅኝት የቫውቸር ግብ ላይ ይደርሳል
LOTTERY_WINየLottery መንኮራኩር የተፈተለ እና ሽልማት ይሰጣል
VOUCHER_PACKአዲስ ካርድ የቴምብር ካርዱን ቫውቸር ጥቅል፣ ሁሉንም ቫውቸሮቹን በአንድ ክስተት ያገኛል
ADMIN_VOUCHER_ISSUEቫውቸር በቀጥታ በካርድ፣ በአስተዳዳሪው ውስጥ ወይም በAPI በኩል ይሰጣል
VOUCHER_REDEEMEDበካርድ ላይ ያለ ቫውቸር፡ በ7Stamp Scanner፣ በAPI፣ በToast POS ወይም በደንበኛው ተወስደዋል
CARD_CAMPAIGNዘመቻ በካርድ አንድ ጊዜ በዘመቻው ቫውቸር ካርዱ ላይ ይደርሳል
BIRTHDAY_GREETINGየልደት ሰላምታ ለካርዱ ይወጣል፣ አንዱ ከተሰጠ በልደት ቀን ቫውቸር
AUTO_MESSAGE_VOUCHERሰር መልእክት ቀስቅሴ ቫውቸር በካርዱ ላይ ያስቀምጣል።
CARD_ADDED_TO_WALLETማለፊያው ወደ Apple Wallet ወይም Google Wallet ታክሏል።
CARD_REMOVED_FROM_WALLETማለፊያው ከኪስ ቦርሳ ውስጥ ይወገዳል

ስካን የደረሰው እያንዳንዱ ግብ ከቅኝቱ አንድ በኋላ የራሱን ክስተት ይልካል ፣ እና በአንድ ቅኝት ሁለት ጊዜ የተደረሰበት ግብ ፣ በካርዱ ላይ ከሁለት ዙር በላይ ፣ ሁለት ይልካል። አዲስ ዙር የሚጀምረው ሙሉ ካርድ አንድ አይነት ካርድ ነው እና ምንም CARD_JOINED አይልክም; አንድ አስተዳዳሪ አሮጌውን ከሰረዘ በኋላ እንደገና የተሰጠ ካርድ። መቀላቀል የቫውቸር ጥቅል እና ማህተም ሲያመጣ፣ CARD_JOINED መጀመሪያ ይመጣል፣ ከዚያ VOUCHER_PACK፣ ከዚያ DELIVERY_INSERT።

ማህተም የሌለው የቴምብር ኮድ DELIVERY_INSERT አይልክም ፣ በአስተዳዳሪው ውስጥ ያለ ካርድ የተፈጠረ ቫውቸር ምንም ADMIN_VOUCHER_ISSUE አይልክም ፣ እና የ API ተደጋጋሚ የቫውቸር ጥሪ አስቀድሞ የወሰደው ሁለተኛ VOUCHER_REDEEMED አይልክም።

አንድ ደንበኛ ግብ ላይ መድረሱን የሚነግረኝ የትኛው ክስተት ነው?

REWARD_EARNED ለAward ግብ፣ VOUCHER_ISSUED ለቫውቸር ግብ እና LOTTERY_WIN ለLottery፣ እያንዳንዱ ከቅኝቱ የራሱ ክስተት በኋላ ይላካል።

ማህተሞች ሲወገዱ Webhook ይላካል?

አዎ። በ7Stamp Scanner ውስጥ የተወገዱ ማህተሞች እንደ SCAN ከአሉታዊ stamps_added ጋር ይደርሳሉ።

በVOUCHER_ISSUED እና ADMIN_VOUCHER_ISSUE መካከል ያለው ልዩነት ምንድን ነው?

VOUCHER_ISSUED የሚመጣው ቅኝት የቫውቸር ግብ ላይ ሲደርስ ነው። ADMIN_VOUCHER_ISSUE የሚመጣው ቫውቸር በቀጥታ ወደ ካርድ፣ በአስተዳዳሪው በእጅ ወይም በAPI በኩል ሲሰጥ ነው።

በቴምብር ኮድ የተቀላቀለ ደንበኛ አንድ ወይም ብዙ ክስተት ይልካል?

በርካታ። CARD_JOINED መጀመሪያ ይመጣል፣ በመቀጠል VOUCHER_PACK የቴምብር ካርዱ የቫውቸር ጥቅል ካለው፣ በመቀጠል DELIVERY_INSERT ከማህተሞቹ ጋር።

ለእያንዳንዱ የዘመቻ መልእክት ክስተት አገኛለሁ?

CARD_CAMPAIGN ዘመቻው ለደረሰው ካርድ አንድ ጊዜ ይላካል፣ የዘመቻው ቫውቸር አንድ ሲይዝ።

Webhook የሚቀበለው

እያንዳንዱ ክስተት አንድ አይነት የJSON አካል አለው፡ የዝግጅቱ መታወቂያ፣ ቢዝነስ እና ክስተቱ በአይነቱ፣ ማህተም ካርዱ፣ ማህተሞች በፊት እና በኋላ፣ የግዢ መጠን፣ የትዕዛዝ መታወቂያ እና external_id የተላከው ውህደት፣ ያገለገለው የሰራተኞች መግቢያ፣ የሰጠው ቫውቸሮች እና ሽልማቶች፣ እና የደንበኛው ስም፣ ኢሜል፣ Telegram፣ የWhatsApp ስልክ እና የትውልድ ቀን።

amount በአነስተኛ ክፍሎች (ሳንቲሞች) የግዢ መጠን ነው፡ ከቅኝቱ ጋር የተላከው 12.50 መጠን 1250 ደርሷል። ክስተቱ ምንም መጠን ሳይኖረው ባዶ ነው።

የክስተት መታወቂያው በሰውነት ውስጥ እና በX-Webhook-Event-Id ራስጌ ውስጥ ነው። ተመሳሳዩን ክስተት እንደገና መሞከር መታወቂያውን ይይዛል፣ ስለዚህ ተቀባዩ ድግግሞሾችን መጣል ይችላል። ለአንድ Make ወይም Zapier URL ክስተቱ ከdata ይልቅ በcard_event ቁልፍ ስር ተቀምጧል።

Webhook ስለ ደንበኛው ምን ውሂብ ይይዛል?

ስም፣ ኢሜል፣ Telegram፣ WhatsApp ስልክ እና የትውልድ ቀን፣ ከቴምብር ካርዱ ጋር፣ ማህተሞች በፊት እና በኋላ፣ እና የተሰጡ ቫውቸሮች እና ሽልማቶች።

መጠኑ በየትኛው ክፍል ውስጥ ነው?

በጥቃቅን ክፍሎች (ሳንቲሞች)። ከቅኝቱ ጋር የተላከ 12.50 መጠን 1250 ደርሷል። ክስተቱ ምንም መጠን በማይኖርበት ጊዜ ባዶ ነው.

ተመሳሳዩን ክስተት ሁለት ጊዜ እንዴት ማስወገድ እንደሚቻል?

የክስተት መታወቂያውን በሰውነት ውስጥ እና በX-Webhook-Event-Id ራስጌ ይጠቀሙ። እንደገና መሞከር አንድ አይነት መታወቂያ ይይዛል።

ለምንድነው ክስተቱ በcard_event ስር የሆነው በ Make?

ለአንድ Make ወይም Zapier URL ክስተቱ ከdata ይልቅ በcard_event ቁልፍ ስር ተቀምጧል ስለዚህ መተግበሪያዎቻቸው ሊለዩት ይችላሉ።

ፊርማ

እያንዳንዱ ማቅረቢያ ተፈርሟል። የX-Webhook-Signature ራስጌ የጊዜ ማህተም እና የዚያ የጊዜ ማህተም እና ጥሬው አካል HMAC-SHA256 ይይዛል፣ በWebhook ሚስጥራዊ ቁልፍ። የምስጢር ቁልፉ በ Webhook ገጽ ላይ ታይቷል እና እንደገና ይፈጠራል። መሰረታዊ የማረጋገጫ መግቢያ እና የይለፍ ቃል ማከልም ይቻላል።

Webhook በእርግጥ ከ7Stamp የመጣ መሆኑን እንዴት ማረጋገጥ እችላለሁ?

የጊዜ ማህተሙን HMAC-SHA256 እና ጥሬውን በWebhook ሚስጥራዊ ቁልፍ አስል እና ከX-Webhook-Signature ራስጌ ጋር አወዳድር።

የዌብሆክን ሚስጥራዊ ቁልፍ የት ነው የማገኘው?

በWebhook ገጽ ላይ፣ እሱም እንደገና ሊፈጠር በሚችልበት።

የመጨረሻ ነጥብዬን በይለፍ ቃል መጠበቅ እችላለሁ?

አዎ። መሰረታዊ የማረጋገጫ መግቢያ እና የይለፍ ቃል በፊርማው አናት ላይ ወደ Webhook ሊታከል ይችላል።

ያልተሳኩ መላኪያዎች

በሠላሳ ሰከንድ ውስጥ 2xx መልስ የማያገኝ ማቅረቢያ እስከ አሥር ጊዜ ያህል እንደገና ይሞከራል፣ እያንዳንዱም ከመጨረሻው በአራት ሰከንድ ይረዝማል፣ ስለዚህ ድጋሚዎቹ በአራት ደቂቃ ውስጥ ያበቃል። ከድጋሚ ሞክር-በኋላ ያለው 429 መልስ ከዚያ ጊዜ በኋላ እንደገና ተሞክሯል። የአንድ ክስተት የመጀመሪያ ውድቀት በአስተዳዳሪው ውስጥ ማሳወቂያን ያስቀምጣል.

በተከታታይ ከመቶ ያልተሳካ ማድረስ በኋላ Webhook በስርዓቱ ታግዷል እና ምንም ተጨማሪ ክስተቶች አያገኝም። ገጹ ከዚያ በፊት ያስጠነቅቃል እና እገዳን አንሳ አዝራር አለው; አንድ የተሳካ ማድረስ ቆጠራውን እንደገና ያስጀምራል።

እያንዳንዱ የዌብ መንጠቆ ገጽ ጥያቄው ተልኳል እና መልሱን ተቀብሎ የማስረከቢያ ጆርናል አለው። ዳግም ላክ ተመሳሳዩን ክስተት እንደገና ወደዚህ Webhook ይልካል።

የእኔ አገልጋይ ጠፍቷል። ክስተቶቹ ጠፍተዋል?

እያንዳንዱ ማድረስ በአራት ደቂቃ ውስጥ እስከ አስር ጊዜ ያህል እንደገና ይሞከራል። ከዚያ በኋላ የዌብሆክን ጆርናል ይክፈቱ እና ለሚፈልጓቸው ዝግጅቶች ዳግም ላክን ይጠቀሙ።

ለምን የእኔ Webhook ክስተቶችን መቀበል አቆመ?

በተከታታይ ከመቶ ያልተሳኩ አቅርቦቶች በኋላ በስርዓቱ ታግዷል። የመጨረሻ ነጥቡን ያስተካክሉ እና በዌብ መንጠቆው ገጽ ላይ እገዳን ያንሱ።

ወደ የእኔ Webhook የተላከውን ማየት እችላለሁ?

አዎ። እያንዳንዱ የዌብ መንጠቆ ገጽ ጥያቄው የተላከበት እና መልሱን ያገኘው የማድረስ ጆርናል አለው።

የውህደት ትር

የውህደት ትር

የውህደት ትሩ ዝግጁ የሆኑትን መንገዶች በቡድን ይዘረዝራል።

  • Stamp በፍተሻዎ — Poster፣ Toast፣ የራስዎ POS ወይም CRM እና የእርስዎን POS አያዩትም?;
  • Fiscal ደረሰኞች - SmartKasa;
  • Automation — Make፣ Zapier እና የህዝብ Swagger።

እያንዳንዱ ካርድ የAPI ቁልፍ ያስፈልገዋል ወይ ይላል። ትሩ በእያንዳንዱ ሀገር ውስጥ ተመሳሳይ ካርዶችን ያቀርባል; የበጀት ደረሰኞች ብቻ በአገር የተገደቡ ናቸው።

የራስዎ POS ወይም CRM

White Label ንግድ Make፣ Zapier ወይም Public Swagger ካርድ አያይም፣ እንዲሁም Poster ወይም በ 7stamp.com ላይ የማዋቀር መመሪያዎች አይቀርቡለትም።

የትኞቹ የ POS ስርዓቶች ለመገናኘት ዝግጁ ናቸው?

Poster፣ እና Toast አንድ ጊዜ ለመድረክ ከበራ - እስከዚያ ድረስ በቅርቡ መምጣትን ያሳያል። ሌሎች ስርዓቶች በAPI በኩል ከራስዎ POS ወይም CRM ጋር ይገናኛሉ።

ውህደቶች በአገር የተገደቡ ናቸው?

ቁ. ትሩ በእያንዳንዱ ሀገር ውስጥ ተመሳሳይ ካርዶችን ያቀርባል. የበጀት ደረሰኞች ብቻ በአገር የተገደቡ ናቸው።

ለምን Make እና Zapier አላየሁም?

ለWhite Label ንግድ አይታዩም። የእሱ API ቁልፎች እና Webhooks ተመሳሳይ ይሰራሉ.

የፖስተር POS

Poster በ Poster የገበያ ቦታ የእኛ መተግበሪያ ነው። በPoster ውስጥ ጫን ዝርዝሩን ይከፍታል፣ እና መተግበሪያው በAPI የሰራተኞች መግቢያ ቁልፍ ተዋቅሯል። ማህተሞቹ እንደ Staff Login’s Card Operations ይቆጠራሉ።

Posterን እንዴት ማገናኘት እችላለሁ?

ውህደትን ይክፈቱ → Poster እና በPoster ውስጥ ጫንን ይምረጡ። መተግበሪያው በAPI የሰራተኞች መግቢያ ቁልፍ ተዋቅሯል።

Poster ማህተሞች የሚጠቀሙት የማን Card Operations ነው?

የ API ቁልፍ መተግበሪያው የሚጠቀምባቸው የሰራተኞች መግቢያ።

ለPoster የAPI ቁልፍ ያስፈልገኛል?

አዎ፣ የሰራተኞች መግቢያ የAPI ቁልፍ።

ቶስት

Toast ለእያንዳንዱ ንግድ በቅርቡ የሚመጣን ያሳያል የToast መዳረሻ በመድረኩ ላይ እስኪዘጋጅ ድረስ። ለጠቅላላው መድረክ አንድ ማብሪያ / ማጥፊያ ነው, የቢዝነስ መቼት አይደለም; አንዴ ከበራ የToast ካርድ ማዋቀሩን ራሱ ይይዛል።

እያንዳንዱ የToast ቦታ በGUID ወደ አንድ የሰራተኞች መግቢያ ተያይዟል፣ ያለ API ቁልፍ፡ ያ የሰራተኞች መግቢያ ቢዝነስ፣ ማህተም ካርድ እና ፕላን ከቦታው ለሚመጣ እያንዳንዱ የToast ጥያቄ ይተገበራል። አንድ ቦታ ከአንድ የስታፍ መግቢያ ጋር ብቻ ሊገናኝ ይችላል፣ እና የስታፍ መግቢያ አንድ ቦታ ይይዛል። የአንድ አካባቢ ጥያቄዎች ግንኙነቱ ከተቋረጠ በኋላ ወይም የሰራተኛ መግቢያው ሲጠፋ ወይም ሲሰረዝ ውድቅ ይደረጋል።

እያንዳንዱ ቫውቸር የToast ሜኑ ምርት ሊሰጠው ይችላል፡ በToast POS ከዚያ ለዚያ ምርት ቅናሽ ይሆናል። ያለ አንድ ቫውቸር በቼኩ ላይ እንደ ዜሮ ቅናሽ ይደረጋል፣ እና ገንዘብ ተቀባዩ ስጦታውን በእጅ ያስረክባል። ቫውቸሮች በToast POS ተወስደዋል፣ እና በተከፈለ ቼክ የደረሰው ጎማ በአንድ ጊዜ ይፈታል። Toast ግብይቱን ሲቀለብስ ማህተሞቹ ይመለሳሉ ወይም የተወሰዱት ቫውቸሮች ይመለሳሉ።

አንድ እንግዳ በToast ኪዮስክ ወይም በእንግዳ የሚመለከት ስክሪን በስልክ ቁጥር ወይም በኢሜል መቀላቀል ይችላል። የስታምፕ ካርዱ በአንድ ጊዜ ይሰጣል; እንግዳው በተመሳሳይ ስልክ ወይም ኢሜል እስኪከፍቱት ድረስ ከ7Stamp ምንም ነገር አያገኝም።

ለምን Toast በቅርቡ ይመጣል ይላል?

የToast መዳረሻ ለመላው መድረክ አንድ መቀየሪያ እንጂ የንግድዎ ቅንብር አይደለም። እስኪበራ ድረስ ምንም የሚያገናኘው ነገር የለም።

የToast አካባቢ እንዴት ተገናኘ?

በእሱ GUID ወደ አንድ የሰራተኞች መግቢያ፣ ያለ API ቁልፍ። ያ የሰራተኞች መግቢያ ማህተም ካርድ እና እቅድ ከቦታው ለሚቀርቡ ጥያቄዎች ሁሉ ተግባራዊ ይሆናል።

Toast ቼክ ሲያፈርስ ማህተሞች ምን ይሆናሉ?

Toast ግብይቱን ሲቀለብስ ማህተሞቹ ይመለሳሉ ወይም የተወሰዱት ቫውቸሮች ይመለሳሉ።

ስማርትካሳ

SmartKasa በውህደት ትር ላይ

SmartKasa ምንም API ቁልፍ አያስፈልገውም። እያንዳንዱን ሱቅ ለመሸፈን በSmartKasa የሱቅ መታወቂያ ወይም በኩባንያው ኮድ የተጨመረው በደረሰኝ ቅኝት ውስጥ ያለ ደረሰኝ ምንጭ ነው። ደንበኞች የSmartKasa ደረሰኝ በንግድ ቻትቦት ውስጥ ይቃኛሉ፣ እና ማህተሞቹ ወደ ደረሰኝ ምንጭ የሰራተኞች መግቢያ ይሄዳሉ።

SmartKasa ዩክሬንኛ ነው, እና የፊስካል ደረሰኞች በዩክሬን, ስሎቫኪያ, ካዛኪስታን እና ኡዝቤኪስታን ውስጥ ብቻ ይሰራሉ.

ለSmartKasa የAPI ቁልፍ ያስፈልገኛል?

ቁ.SmartKasa በደረሰኝ ቅኝት ውስጥ በሱቅ መታወቂያ ወይም በኩባንያው ኮድ የተጨመረ ደረሰኝ ምንጭ ነው።

ደንበኞች የSmartKasa ደረሰኝ የሚቃኙት የት ነው?

በንግድዎ Chatbot ውስጥ። ማህተሞቹ ወደዚያ ደረሰኝ ምንጭ የሰራተኞች መግቢያ ይሄዳሉ።

በየትኞቹ አገሮች የበጀት ደረሰኞች ይሠራሉ?

በዩክሬን, ስሎቫኪያ, ካዛክስታን እና ኡዝቤኪስታን.

Make እና Zapier

Make በውህደት ትር ላይ

ለ Make የሚሆነው የ7Stamp መተግበሪያ በ Make ይፋዊ የመተግበሪያ ቤተ-መጽሐፍት ውስጥ ይገኛል፡ በማንኛውም የ Make ሁኔታ ውስጥ 7Stampን ይፈልጉ ወይም በውህደት ትር ላይ በ Make ክፈትን ይጠቀሙ። የእኛ የ Zapier መተግበሪያ በ Zapier ይፋዊ ማውጫ ውስጥ የለም፡ በZapier ክፈት መተግበሪያውን ወደ ቢዝነሱ የራሱ Zapier መለያ የሚያክል ግብዣ ነው። ሁለቱም መተግበሪያዎች በሰራተኞች መግቢያ API ቁልፍ ይሰራሉ።

የMake ሁኔታዎች እና Zaps የሚጀምሩት በ7Stamp Webhooks ነው፣ ስለዚህ ቀስቅሴዎች የWebhooks & Events ተጨማሪ ያስፈልጋቸዋል። እንደ ቴምብሮች መጨመር ወይም ቫውቸር መስጠት ያሉ ድርጊቶች የAPI ቁልፍ ብቻ ያስፈልጋቸዋል። Make እና Zapier ለWhite Label ንግድ አይሰጡም።

የ7Stamp መተግበሪያን በ Make እና በ Zapier ውስጥ የት አገኛለሁ?

በ Make ውስጥ በማንኛውም ሁኔታ 7Stampን ይፈልጉ — መተግበሪያው በ Make ይፋዊ የመተግበሪያ ቤተ-መጽሐፍት ውስጥ ይገኛል። በ Zapier ውስጥ ገና ይፋዊ አይደለም፣ ስለዚህ በውህደት ትር ላይ በZapier ክፈትን ይጠቀሙ - ግብዣው መተግበሪያውን በራስዎ መለያ ላይ ይጨምራል።

Make እና Zapier የWebhooks & Events ተጨማሪ ይፈልጋሉ?

ቀስቅሴዎች ያደርጋሉ፣ ምክንያቱም ሁኔታዎች እና ዛፕ በ7Stamp Webhooks የተጀመሩ ናቸው። እንደ ቴምብሮች መጨመር ወይም ቫውቸር መስጠት ያሉ ድርጊቶች የAPI ቁልፍ ብቻ ያስፈልጋቸዋል።

ለ Make ወይም Zapier የAPI ቁልፍ ያስፈልገኛል?

አዎ። መተግበሪያዎቹ ከAPI የሰራተኞች መግቢያ ቁልፍ ጋር ይሰራሉ።

Reference
Operations 28 ኦክቶበር 2026

እቅዶች እና የሂሳብ አከፋፈል

ሦስቱ ዕቅዶች፣ Card Operation ምንድን ነው፣ ምን እንደሚቆጠር እና ነፃ የሆነው፣ add-ons፣ Packages ከAccess Code እና ክፍያ ሳይሳካ ሲቀር ምን ይከሰታል።

የታደሰበት: 28 ኦክቶበር 2026

ጽሑፉን ክፈት
Reference
Operations 28 ኦክቶበር 2026

የሰራተኞች መዳረሻ

የሰራተኛ መግቢያ ምን ማለት ነው፣ አንዱን እንዴት መፍጠር፣ መቀየር፣ ማጥፋት እና መሰረዝ እንደሚቻል፣ ሰራተኞች እንዴት ወደ 7Stamp Scanner እንደሚገቡ፣ እዚያ ምን ማድረግ እንደሚችሉ እና የአስተዳዳሪ ፓነልን ማን ይጠቀማል።

የታደሰበት: 28 ኦክቶበር 2026

ጽሑፉን ክፈት
Reference
Operations 28 ኦክቶበር 2026

ደንበኞች እና ታሪክ

የደንበኞች ማህተም ካርዶች ዝርዝር፣ የደንበኛ ካርድ ገጽ፣ ካርድ መሰረዝ፣ የክስተት መዝገብ፣ 7Stamp ስለ ደንበኛ የሚያቆየው እና የደንበኛ ውሂብ እንዴት እንደሚሰረዝ።

የታደሰበት: 28 ኦክቶበር 2026

ጽሑፉን ክፈት