የ Zinn® ማስተናገጃን ከራስዎ ሲስተሞች መሸጥ

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

ደንበኞችዎ በትክክል የሚያዩት

ከዝርዝር አሠራሩ በፊት፦ ደንበኞችዎ እኛን ማየት ፈጽሞ አይኖርባቸውም። ሦስት ገጾች አሉ፣ እና እርስዎ የትኛውን እንደሚጠቀሙ ይመርጣሉ።

⛔ የትኛውንም ቢመርጡ፣ ለደንበኞችዎ ህጋዊ የሽያጭ ነጋዴው (merchant of record) እርስዎ ነዎት፦ የእርስዎ ዋጋዎች፣ የእርስዎ ደረሰኞች፣ የእርስዎ የተእታ (VAT) ቁጥር፣ የእርስዎ የክፍያ አቅራቢ። እኛ በጅምላ ዋጋ በወር አንድ ጊዜ ሂሳብ የምንጠይቀው እርስዎን ነው።

አንዴ የፓነል የሆስት ስም ካዘጋጁ በኋላ፣ በWordPress ፕለጊኑ Panel address መስክ ውስጥ ብቻ ያስቀምጡት እንጂ በሌላ በማንኛውም ነገር ውስጥ አያስቀምጡት — ይህ API የሚያመነጫቸው የመግቢያ ሊንኮች በራስ-ሰር ይከተሉታል።

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

አራት የመግቢያ መንገዶች አሉ፣ እና ሁሉም ከስር አንድ አይነት ነገር ያከናውናሉ፦

1. የAPI ቁልፍ ያግኙ

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

⛔ ለማቀናጃ (integration) reseller.manageን አይስጡ። ያ ፈቃድ የዋጋ ዝርዝርዎን እና የራስዎን የክፍያ መተላለፊያ ምስክርነቶች ያርማል። reseller.provision በትክክል የተዘጋጀው ወደ የሂሳብ አከፋፈል ፓነል ወይም ድረ-ገጽ የሚለጥፉት ቁልፍ እርሱን እንዳይፈልገው ነው።

ቁልፉ የሚታየው አንድ ጊዜ ብቻ ነው። ሌሎች ምስክርነቶችዎን በሚያስቀምጡበት ቦታ ያስቀምጡት — የድር አገልጋይዎ በሚያቀርበው ፋይል ውስጥ ፈጽሞ አያስቀምጡት።

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

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

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

3. ሙሉው ውህደት፣ በስድስት ጥሪዎች

መቼ                 ይጥሩ
ትዕዛዝ ሲከፈል        POST   /v1/orgs                                   በእያንዳንዱ CUSTOMER አንድ ጊዜ
                    POST   /v1/sites                                  በእያንዳንዱ SERVICE አንድ ጊዜ
ክፍያ ካልፈጸሙ       POST   /v1/reseller/services/{siteId}/suspend
ክፍያ ሲፈጽሙ        POST   /v1/reseller/services/{siteId}/unsuspend
ሲሰርዙ              DELETE /v1/sites/{siteId}
"ወደ ሆስቲንግ ይግቡ"  POST   /v1/reseller/services/{siteId}/sso

ማዘጋጀት ሁለት ጥሪዎች ናቸው፣ እና ቁልፎቹ ወሳኝ ናቸው፦

# 1. የደንበኛው መለያ — በእርስዎ የደንበኛ መታወቂያ (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. የእነሱ ጣቢያ — በእርስዎ የአገልግሎት መታወቂያ (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"}'

ሲሳሳቷቸው ገንዘብ የሚያስወጡ ሁለት ደንቦች

1. መለያውን በCUSTOMERዎ ላይ እና ጣቢያውን በSERVICEዎ ላይ ይመስርቱ። የአንድ ደንበኛ ሁለተኛ ትዕዛዝ ቀድሞ ባላቸው መለያ ውስጥ መግባት አለበት። ሁለቱንም በአገልግሎቱ ላይ ከመሰረቱ አንድ ደንበኛ ያልተገናኙ ሦስት መለያዎች እና ሦስት የተለያዩ ፓነሎች ይኖሩታል።
2. ለእቃው በራስዎ መታወቂያ ላይ የተገነባ Idempotency-Key በእያንዳንዱ POST ላይ ይላኩ። እያንዳንዱ የክፍያ ስርዓት በድጋሚ ይሞክራል — የመተላለፊያ ጥሪ ሁለት ጊዜ ይመጣል፣ አስተዳዳሪ ያልተሳካ ዝግጅትን በድጋሚ ያስኬዳል፣ ደንበኛ ሁለት ጊዜ ጠቅ ያደርጋል። ያለ ቁልፉ ሁለተኛው ሙከራ ሁለተኛ ጣቢያ ይፈጥራል እና ለእርሱም ሂሳብ ይጠየቃሉ።

ወደ ሁለት ማሳነስ የሌለብዎት ሦስት መልሶች

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

4. ደንበኛን ያስገቡ

POST /v1/reseller/services/{siteId}/sso ደንበኛዎን ቀድሞውኑ ወደ ገቡበት የራሳቸው መለያ በቀጥታ የሚያስገባ የአንድ ጊዜ አገልግሎት URL ይመልሳል።

⛔ ሲጫኑ ብቻ ያመንጩት፣ ገጹን በሚያዘጋጁበት ጊዜ ፈጽሞ አያመንጩት። ሊንኩ ለአንድ ጊዜ ብቻ የሚያገለግል እና በጥቂት ደቂቃዎች ውስጥ ጊዜው የሚያበቃ ነው፣ ስለዚህ በገጽ ውስጥ የተጻፈ ሊንክ በመጀመሪያው የገጽ ዕይታ ላይ ዋጋ ያጣል እና በእርስዎ እና በአሳሹ መካከል ባለው እያንዳንዱ መሸጎጫ (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> ላይ ይገኛል፣ ወይም በዳሽቦርድዎ ውስጥ ከPlugins ያውርዱት።

6. በቀጥታ ስራ ይጀምሩ

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

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

ሌሎች ነገሮች በሙሉ የሚገኙበት ቦታ

የተሟላው የAPI ማጣቀሻ — እያንዳንዱ የመጨረሻ ነጥብ፣ ከእኛ ዝርዝር መግለጫ የተመነጨ፣ እያንዳንዳቸው ከሚፈልጉት ፈቃድ ጋር — በ<https://zinndigital.com/developers/api> ይገኛል።