የራስዎ ሲስተም ጀምሮ የ Zinn® ዎችንዲንግ መሸጥ

የዚን (Zinn) ሆስቲንግን ከራስዎ የቢሊንግ ፓነል፣ የዎርድፕረስ (WordPress) ሳይት ወይም ስክሪፕቶች ያስተዳድሩ፡ ኤፒአይ ኪ (API key) ያግኙ፣ የመጀመሪያ ጥሪዎን ያድርጉ፣ እና ሙሉውን ውህደት የያዙትን ስድስት ጥሪዎች ይጠቀሙ።

የእኛን ሆስቲንግ መልሰው ይሸጣሉ። ደንበኞችዎ የእርስዎ ናቸው፦ የእርስዎ ዋጋዎች፣ የእርስዎ ደረሰኞች፣ የእርስዎ የክፍያ አቅራቢ። ቀድመው ከሚያንቀሳቅሱት ማንኛውም ነገር — የክፍያ ፓነል፣ የእርስዎ የWordPress ጣቢያ ወይም ስክሪፕት — የእኛን ፕላትፎርም የሚያስተዳድሩት በዚህ መንገድ ነው።

ደንበኞችዎ በእርግጥ የሚያዩት ነገር

ወደ ዝርዝር መካኒኮች ከመግባታችን በፊት፦ ደንበኞችዎ እኛን ማየት አያስፈልጋቸውም። ሦስት አማራጮች አሉ፣ እርስዎ የትኛውን እንደሚጠቀሙ ይመርጣሉ።

| አማራጭ | የእሱ ባለቤት ማን ነው | |---|---| | በራስዎ የሆስት ስም ላይ ያለ የሆስቲንግ ፓነል | በ Reselling → Your brand ስር የፓነል የሆስት ስም ያዘጋጁ እና ደንበኞችዎ በእርስዎ ሎጎ እና ቀለሞች በ panel.yourcompany.com ላይ ይገቡ። ተመሳሳይ ፓነል፣ የእርስዎ አድራሻ። | | የራስዎ ዌብሳይት | የ WordPress ፕለጊኑ የዶሜይን ፍለጋ እና የአንድ-ክሊክ መግቢያ ሊንክ በጣቢያዎ ላይ ያደርጋል፣ እና ትዕዛዙን በራስዎ የ WooCommerce ቼክአውት በኩል ያስኬዳል። | | የእርስዎ የክፍያ ፓነል | WHMCS ወይም HostBill እንደ ዋና መግቢያ ሆኖ ይቆያል፤ ሞጁሉ ከበስተጀርባ አገልግሎቱን ያዘጋጃል እና በደንበኛ ቦታ ላይ ያለው አዝራር በቀጥታ ወደ ሆስቲንጋቸው ያገባቸውል። |

⛔ የትኛውንም ቢመርጡ፣ ለደንበኞችዎ የመዝገብ ነጋዴ (merchant of record) እርስዎ ነዎት፦ የእርስዎ ዋጋዎች፣ የእርስዎ ደረሰኞች፣ የእርስዎ የተጨማሪ እሴት ታክስ (VAT) ቁጥር፣ የእርስዎ የክፍያ አቅራቢ። እኛ ለእርስዎ በጅምላ ዋጋ በወር አንድ ጊዜ ደረሰኝ እንልካለን።

አንዴ የፓነል የሆስት ስም ካዘጋጁ በኋላ፣ በ WordPress ፕለጊኑ የ Panel address ሜዳ ላይ ብቻ ያስገቡት — ይህ API የሚያወጣቸው የመግቢያ ሊንኮች በራስ-ሰር ይከተሉታል።

አራቱ የመግቢያ መንገዶች

አራት የመግቢያ መንገዶች አሉ፣ ሁሉም ከበስተጀርባ ተመሳሳይ ነገር ያከናውናሉ፦

| | ለ | |---|---| | የ WHMCS ሞጁል | የ WHMCS ሱቅ | | የ HostBill ሞጁል | የ HostBill ሱቅ | | የ WordPress ፕለጊን | ከራስዎ WordPress ወይም WooCommerce ጣቢያ ለመሸጥ | | API | ለማንኛውም ሌላ ነገር — Blesta፣ የውስጥ ሲስተም፣ የ cron ስክሪፕት |

1. API ቁልፍ ያግኙ

በዳሽቦርድዎ ውስጥ ወደ API keys ይሂዱ እና አንድ ቁልፍ ይፍጠሩ። የሚያስፈልገውን ፈቃድ ብቻ ይስጡት፦

| ፈቃድ | ለምን | |---|---| | org.read | የደንበኛ መለያዎችዎን ለማንበብ | | sites.create | ጣቢያ ለማዘጋጀት (provision) | | sites.view | አገልግሎትን ለማንበብ | | sites.delete | ለማቋረጥ (terminate) | | reseller.view | አገልግሎቶችዎን ለመዘርዘር እና አጠቃቀምን ለማንበብ | | reseller.provision | ለማገድ፣ ለመልቀቅ እና ደንበኛን ለማስገባት |

⛔ ለማዋሃጃ (integration) reseller.manage ፈቃድ አይስጡ። ያ ፈቃድ የዋጋ ዝርዝርዎን እና የራስዎን የክፍያ ጌትዌይ መረጃዎች ያዘጋጃል። reseller.provision የተፈጠረው በክፍያ ፓነል ወይም ዌብሳይት ውስጥ የሚለጥፉት ቁልፍ እሱ እንዳያስፈልገው በትክክል ነው።

ቁልፉ የሚታየው አንድ ጊዜ ብቻ ነው። ከሌሎች ምስጢራዊ መረጃዎችዎ ጋር ያስቀምጡት — የዌብ ሰርቨርዎ በሚያቀርበው ፋይል ውስጥ በጭራሽ አታስቀምጡት።

2. የመጀመሪያ ጥሪዎን ያድርጉ

curl https://api.zinndigital.com/v1/reseller/services \
  -H "Authorization: Bearer zdk_live_…"

ያ ያዘጋጇቸውን እያንዳንዱን አገልግሎቶች፣ ለእያንዳንዱ ጣቢያ አንድ ረድፍ፣ ከአካታች ደንበኛው፣ ከሁኔታው እና ከሚያስከፍሉት ዋጋ ጋር ይመልሳል። በአዲስ መለያ ላይ ባዶ ዝርዝር ይመልሳል — ይህም ትክክለኛው መልስ እንጂ ስህተት አይደለም።

3. ሙሉው ማዋሃድ፣ በስድስት ጥሪዎች

WHEN                 CALL
an order is paid     POST   /v1/orgs                                   once per CUSTOMER
                     POST   /v1/sites                                  once per SERVICE
they have not paid   POST   /v1/reseller/services/{siteId}/suspend
they pay             POST   /v1/reseller/services/{siteId}/unsuspend
they cancel          DELETE /v1/sites/{siteId}
"log in to hosting"  POST   /v1/reseller/services/{siteId}/sso

አገልግሎት ማዘጋጀት (provisioning) ሁለት ጥሪዎች አሉት፣ እና ቁልፎቹ ወሳኝ ናቸው፦

# 1. the customer's account — keyed on YOUR customer id
curl -X POST https://api.zinndigital.com/v1/orgs \
  -H "Authorization: Bearer zdk_live_…" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: account-4211" \
  -d '{"type":"customer","name":"Acme Ltd"}'

# 2. their site — keyed on YOUR service id
curl -X POST https://api.zinndigital.com/v1/sites \
  -H "Authorization: Bearer zdk_live_…" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: service-9915" \
  -d '{"org_id":"<from step 1>","product_line":"mainstream","primary_domain":"acme.com"}'

በስህተት ሲሰሯቸው ገንዘብ የሚያስወጡ ሁለት ህጎች

መለያውን በደንበኛዎ (CUSTOMER) መታወቂያ እና ጣቢያውን በአገልግሎትዎ (SERVICE) መታወቂያ ቁልፍ ያድርጉ። የደንበኛ ሁለተኛ ትዕዛዝ ቀድሞ ባላቸው መለያ ውስጥ መግባት አለበት። ሁለቱንም በአገልግሎት ላይ ቁልፍ ካደረጉ፣ አንድ ደንበኛ ሶስት ያልተያያዙ መለያዎች እና ሶስት የተለዩ ፓነሎች ይኖሩታል።
በእያንዳንዱ POST ላይ ለነገሩ ካለዎት የራስዎ id የተገነባ Idempotency-Key ይላኩ። እያንዳንዱ የክፍያ ሲስተም እንደገና ይሞክራል — የጌትዌይ ጥሪ ሁለት ጊዜ ይደርሳል፣ አስተዳዳሪ ያልተሳካ ዝግጅትን እንደገና ያንቀሳቅሳል፣ ደንበኛ ሁለት ጊዜ ይጫናል። ያለ ቁልፉ ሁለተኛው ሙከራ ሁለተኛ ጣቢያ ይፈጥራል እና ለእሱ ክፍያ ይጠየቃሉ።

ወደ ሁለት ማቃለል የሌለብዎት ሶስት መልሶች

unsuspend የ 409 መልስ ሊሰጥ ይችላል። ይህ ማለት የእኛ ጥሰት ተቆጣጣሪ ቡድን ጣቢያውን ይዞታል እንጂ እርስዎ አይደሉም ማለት ነው። መልእክቱን ያሳዩ፤ እንደገና አይሞክሩት።
**ማቋረጥ (Terminating) ማጥፋትን ያቀዳጃል እንጂ ወዲያውኑ አያጠፋም።** ቀኑ እንደ pending_deletion_at ሆኖ ይመለሳል። መረጃቸው ገና ሳይጠፋ እንደጠፋ ለደንበኛ መናገር ምንም ካለመናገር የከፋ ነው።
disk_used_bytes ዋጋው null ሊሆን ይችላል፣ እና null ማለት ዜሮ ማለት አይደለም። ይህ ማለት መለካት አልቻልንም ማለት እንጂ ምንም አልተጠቀሙም ማለት አይደለም። ይለፉት — በራስዎ መዝገቦች ውስጥ 0 ብለው አይጻፉ፣ ካልሆነ ምንም ንባብ ለሌለዎት ጣቢያ ለደንበኛ የአጠቃቀም አረንጓዴ አሞሌ ያሳያሉ።

4. ደንበኛን ያግቡ

POST /v1/reseller/services/{siteId}/sso ደንበኛዎን ቀድሞ እንደገባ አድርጎ በቀጥታ ወደራሱ መለያ የሚያስገባ የአንድ ጊዜ ጥቅም ላይ የሚውል URL ይመልሳል።

⛔ ሲጫኑ ብቻ ያውጡት (mint)፣ ገጹን በሚያቀርቡበት ጊዜ በጭራሽ አይሁን። ሊንኩ የአንድ ጊዜ ጥቅም ላይ የሚውል እና በደቂቃዎች ውስጥ የሚያልፍበት ነው፣ ስለዚህ በገጽ ውስጥ የተፃፈ ሊንክ በመጀመሪያው የገጽ እይታ ላይ ይቃጠላል እና በእርስዎ እና በብራውዘሩ መካከል ባለው እያንዳንዱ ካሽ (cache) ውስጥ ይቀራል።

5. በምትኩ ሞጁል ይጫኑ

WHMCS — ሞጁሉን ወደ modules/servers/zinn/ ኮፒ ያድርጉ፣ Password የ API ቁልፍዎ የሆነ ሰርቨር ይጨምሩ፣ እና በምርቱ ላይ የምርት መስመሩን ያዘጋጁ። Test Connection የሚለውን ይጫኑ፦ እውነተኛ ጥሪ ያደርጋል እና ፕላትፎርሙ ያለውን ይነግርዎታል።
HostBill — ወደ includes/modules/Hosting/zinn/ ኮፒ ያድርጉ እና በተመሳሳይ መንገድ ያገናኙት።
WordPress — Zinn® Reseller Toolkit፦ የዶሜይን ፍለጋ፣ ወደ ደንበኞችዎ ሆስቲንግ የሚያስገባ ሊንክ፣ እና ክፍያ ሲፈጸም የ WooCommerce አገልግሎት ማዘጋጀት። በ <https://github.com/Zinn-Digital/zinn-reseller-toolkit> ላይ ክፍት ምንጭ (open source) ነው፣ ወይም በዳሽቦርድዎ ውስጥ ከ Plugins ማውረድ ይችላሉ።

6. ወደ ስራ ይግቡ

እውነተኛ ትዕዛዝ ከመቀበልዎ በፊት እነዚህን ያረጋግጡ፦

በሞጁሉ ላይ ያለው የግንኙነት ሙከራ ይሳካል፣ ወይም የመጀመሪያው የ curl ጥሪዎ ዝርዝር ይመልሳል።
የዋጋ ዝርዝርዎ ተዘጋጅቷል (Reselling → Your prices)።
የክፍያ ጌትዌይዎ ተገናኝቷል (Reselling → Payment gateways) — ደንበኞችዎ በራስዎ መለያ በኩል ለእርስዎ ይከፍሉዎታል።
ደንበኞችዎ የሚያገኙት ደረሰኝ የእርስዎን ህጋዊ ድርጅት እና የ VAT ቁጥር እንጂ የእኛን እንዳይይዝ የድርጅትዎ ዝርዝሮች ተሞልተዋል (Reselling → Your company)።
አንድ እውነተኛ ትዕዛዝ ከጫፍ እስከ ጫፍ ሞክረው ጣቢያው ሲፈጠር ተከታትለዋል።

ሌላው ነገር ሁሉ የት ይገኛል

ሙሉው የ API ማጣቀሻ — እያንዳንዱ ኤንድፖይንት፣ ከእኛ ስፔስፊኬሽን የተፈጠረ፣ እያንዳንዳቸው በሚያስፈልጋቸው ፈቃድ — በ <https://zinndigital.com/developers/api> ይገኛል።