ඔyour own systems හරහා Zinn® හෝස්ටිං අලෙවි කිරීම

ඔබ අපගේ හොස්ටින් නැවත අලෙවි කරයි. ඔබගේ පාරිභෝගිකයින් ඔබගේමය: ඔබගේ ගාස්තු, ඔබගේ ඉන්වොයිසි, ඔබගේ ගෙවීම් සපයන්නා. ඔබ දැනටමත් පවත්වාගෙන යන ඕනෑම දෙයකින් — බිල්පත් පැනලයක්, ඔබගේම WordPress අඩවියක්, හෝ ස්ක්‍රිප්ට් එකක් මගින් — අපගේ වේදිකාව ක්‍රියාත්මක කරන්නේ මෙසේය.

ඔබගේ පාරිභෝගිකයින් සැබවින්ම දකින දේ

තාක්ෂණික කරුණුවලට පෙර: ඔබගේ පාරිභෝගිකයින්ට අපව කිසි විටෙකත් දැකීමට අවශ්‍ය නොවේ. මතුපිට තුනක් ඇත, ඔබ භාවිතා කරන්නේ කුමක්දැයි ඔබම තෝරා ගනී.

| මතුපිට | එය අයිති කාටද | |---|---| | ඔබගේම හොස්ට්නාමයේ ඇති හොස්ටින් පැනලය | Reselling → Your brand යටතේ පැනල හොස්ට්නාමයක් සකසන්න, එවිට ඔබගේ පාරිභෝගිකයින් ඔබගේ ලාංඡනය සහ වර්ණ සහිතව panel.yourcompany.com ඔස්සේ පුරනය වනු ඇත. එකම පැනලය, ඔබගේ ලිපිනය. | | ඔබගේම වෙබ් අඩවිය | WordPress ප්ලගිනය මගින් ඩොමේන් සෙවීම සහ එක් ක්ලික් කිරීමකින් පුරනය වීමේ ලින්ක් එකක් ඔබගේ අඩවියට එකතු කරන අතර, ඔබගේම WooCommerce චෙක්අවුට් එක හරහා ඇණවුම භාර ගනී. | | ඔබගේ බිල්පත් පැනලය | WHMCS හෝ HostBill ඉදිරිපස දොරටුව ලෙස පවතී; මොඩියුලය ඊට පසුපසින් සේවාව සපයන අතර, පාරිභෝගික කලාපයේ බොත්තම මගින් ඔවුන්ව කෙලින්ම ඔවුන්ගේ හොස්ටින් වෙත පුරනය කරයි. |

⛔ ඔබ කුමක් තෝරා ගත්තද, ඔබගේ පාරිභෝගිකයින් සඳහා නිල වෙළෙන්දා ඔබයි: ඔබගේ ගාස්තු, ඔබගේ ඉන්වොයිසි, ඔබගේ VAT අංකය, ඔබගේ ගෙවීම් සපයන්නා. අපි මසකට වරක්, තොග මිල ගණන් යටතේ ඔබට බිල්පත් කරමු.

ඔබ පැනල හොස්ට්නාමයක් සැකසූ පසු, එය WordPress ප්ලගිනයේ Panel address තීරුවේ පමණක් ඇතුළත් කරන්න — මෙම API එක මගින් සාදන පුරනය වීමේ ලින්ක් ස්වයංක්‍රීයව එය අනුගමනය කරයි.

ඇතුළු වීමේ ක්‍රම හතර

ඇතුළු වීමේ ක්‍රම හතරක් ඇත, ඒ සියල්ල යටින් සිදු කරන්නේ එකම දේය:

| | සඳහා | |---|---| | WHMCS මොඩියුලය | WHMCS සාප්පුවක් | | HostBill මොඩියුලය | HostBill සාප්පුවක් | | WordPress ප්ලගිනය | ඔබගේම WordPress හෝ WooCommerce අඩවියෙන් අලෙවි කිරීම | | API එක | වෙනත් ඕනෑම දෙයක් — Blesta, අභ්‍යන්තර පද්ධතියක්, ක්‍රොන් (cron) ස්ක්‍රිප්ට් එකක් |

1. API කී එකක් ලබා ගන්න

ඔබගේ උපකරණ පුවරුවේ (dashboard), API keys වෙත ගොස් එකක් සාදන්න. ඊට අවශ්‍ය දේ පමණක් ලබා දෙන්න:

| අවසරය | හේතුව | |---|---| | org.read | ඔබගේ පාරිභෝගික ගිණුම් කියවීමට | | sites.create | අඩවියක් සැපයීමට (provision) | | sites.view | සේවාවක් කියවීමට | | sites.delete | අවසාන කිරීමට (terminate) | | reseller.view | ඔබගේ සේවාවන් ලැයිස්තුගත කිරීමට සහ භාවිතය කියවීමට | | reseller.provision | අත්හිටුවීමට, මුදා හැරීමට, සහ පාරිභෝගිකයෙකු පුරනය කිරීමට |

⛔ සංකලනයකට (integration) reseller.manage ලබා නොදෙන්න. එම අවසරය මගින් ඔබගේ මිල ලැයිස්තුව සහ ඔබගේම ගෙවීම්-දොරටු (payment-gateway) සාධනීය තොරතුරු සංස්කරණය කරයි. බිල්පත් පැනලයකට හෝ වෙබ් අඩවියකට ඔබ අලවන කී එකකට මෙම අවසරය අවශ්‍ය නොවන නිසාම reseller.provision පවතී.

කී එක පෙන්වනුයේ එක් වරක් පමණි. ඔබගේ වෙනත් සාධනීය තොරතුරු ගබඩා කරන ස්ථානයක එය ගබඩා කරන්න — ඔබගේ වෙබ් සර්වරය මගින් ලබා දෙන ගොනුවක කිසි විටෙකත් ගබඩා නොකරන්න.

2. ඔබගේ පළමු ඇමතුම (call) ගන්න

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

එයින් ඔබ ලබා දී ඇති සෑම සේවාවක්ම, එක් අඩවියකට එක් පේළිය බැගින්, එය අයත් පාරිභෝගිකයා, එහි තත්ත්වය, සහ ඒ සඳහා ඔබ අය කරන මුදල සමඟ ආපසු ලබා දෙයි. අලුත් ගිණුමක එය හිස් ලැයිස්තුවකි — එය දෝෂයක් නොව නිවැරදි පිළිතුරයි.

3. සම්පූර්ණ සංකලනය, ඇමතුම් හයකින්

අවස්ථාව              ඇමතුම
ඇණවුමකට ගෙවූ විට     POST   /v1/orgs                                   පාරිභෝගිකයෙකුට එක් වරක්
                     POST   /v1/sites                                  සේවාවකට එක් වරක්
ගෙවීම් කර නැති විට   POST   /v1/reseller/services/{siteId}/suspend
ඔවුන් ගෙවූ විට       POST   /v1/reseller/services/{siteId}/unsuspend
ඔවුන් අවලංගු කළ විට DELETE /v1/sites/{siteId}
"හොස්ටින් එකට පුරනය වන්න" POST   /v1/reseller/services/{siteId}/sso

සැපයීම යනු ඇමතුම් දෙකකි, තවද කී වැදගත් වේ:

# 1. පාරිභෝගිකයාගේ ගිණුම — ඔබගේ පාරිභෝගික 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. ඔවුන්ගේ අඩවිය — ඔබගේ සේවා 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. ගිණුම ඔබගේ පාරිභෝගිකයා මතද, අඩවිය ඔබගේ සේවාව මතද පදනම් කරන්න. පාරිභෝගිකයෙකුගේ දෙවන ඇණවුම ඔවුන්ට දැනටමත් තිබෙන ගිණුමට ඇතුළත් විය යුතුය. දෙකම සේවාව මත පදනම් කළහොත්, එක් පාරිභෝගිකයෙකුට අදාළ නැති ගිණුම් තුනක් සහ වෙනම පැනල තුනක් ලැබෙනු ඇත.
2. එම දේ සඳහා ඔබගේම ID එකෙන් තැනූ Idempotency-Key එකක් සෑම POST එකකදීම යවන්න. සෑම බිල්පත් පද්ධතියක්ම නැවත උත්සාහ කරයි — ගෙවීම් දොරටුවක පසු-ඇමතුමක් (callback) දෙවරක් පැමිණීම, පරිපාලකයෙකු අසාර්ථක වූ සැපයීමක් නැවත ක්‍රියාත්මක කිරීම, පාරිභෝගිකයෙකු දෙවරක් ක්ලික් කිරීම සිදු විය හැක. කී එක නොමැතිව, දෙවන උත්සාහයේදී දෙවන අඩවියක් සෑදෙන අතර ඒ සඳහා ඔබට බිල්පත් කරනු ඇත.

ඔබ දෙකකට සූක්ෂ්ම නොකළ යුතු පිළිතුරු තුනක්

• unsuspend සඳහා 409 පිළිතුර ලැබිය හැක. ඉන් අදහස් වන්නේ ඔබ නොව අපගේ අවභාවිත විමර්ශන කණ්ඩායම අඩවිය අත්හිටුවා ඇති බවයි. පණිවිඩය පෙන්වන්න; නැවත උත්සාහ නොකරන්න.
• **අවසාන කිරීම මගින් ඉවත් කිරීමක් ත කාලසටහන්ගත කරයි, එය ඉවත් කිරීමක් සිදු නොකරයි.** දිනය pending_deletion_at ලෙස ආපසු පැමිණේ. දත්ත තවමත් පවතින විට ඒවා ඉවත් වී ඇති බව පාරිභෝගිකයෙකුට පැවසීම කිසිවක් නොකියා සිටිනවාට වඩා නරක ය.
• disk_used_bytes යන්න null විය හැක, null යනු බිංදුව නොවේ. ඉන් අදහස් වන්නේ අපට මැනීමට නොහැකි වූ බව මිස කිසිවක් භාවිතා නොකළ බව නොවේ. එය මඟ හරින්න — ඔබගේම වාර්තාවල 0 ලෙස ලියන්න එපා, එසේ වුවහොත් ඔබට කිසිදු දත්තයක් නොලැබුණු අඩවියක් සඳහා පාරිභෝගිකයාට කොළ පැහැති භාවිත තීරුවක් පෙනෙනු ඇත.

4. පාරිභෝගිකයෙකු පුරනය කරන්න

POST /v1/reseller/services/{siteId}/sso මගින් ඔබගේ පාරිභෝගිකයා දැනටමත් පුරනය වී ඇති ඔවුන්ගේම ගිණුමට කෙලින්ම යොමු කරන එක් වරක් පමණක් භාවිතා කළ හැකි URL එකක් ලබා දෙයි.

⛔ ඔවුන් ක්ලික් කළ විට එය සාදන්න, පිටුව නිරූපණය වන (render) විට කිසි විටෙකත් නොසාදන්න. ලින්ක් එක එක් වරක් පමණක් භාවිතා කළ හැකි අතර මිනිත්තු කිහිපයකින් කල් ඉකුත් වේ, එබැවින් පිටුවක ලියන ලද ලින්ක් එකක් පළමු පිටු නැරඹුමේදීම භාවිතයට ගත නොහැකි වන අතර ඔබ සහ බ්‍රවුසරය අතර ඇති සෑම කැෂ් (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. සක්‍රිය වන්න (Go live)

සැබෑ ඇණවුමක් ගැනීමට පෙර මෙවා පරීක්ෂා කරන්න:

• මොඩියුලයේ සම්බන්ධතා පරීක්ෂණය සාර්ථක වේ, නැතහොත් ඔබගේ පළමු curl මගින් ලැයිස්තුවක් ලබා දෙයි.
• ඔබගේ මිල ලැයිස්තුව සකසා ඇත (Reselling → Your prices).
• ඔබගේ ගෙවීම් දොරටුව සම්බන්ධ කර ඇත (Reselling → Payment gateways) — ඔබගේ පාරිභෝගිකයින් ඔබගේම ගිණුම හරහා ඔබට ගෙවයි.
• ඔබගේ පාරිභෝගික ඉන්වොයිසිවල අපගේ තොරතුරු නොව ඔබගේ නීතිමය ආයතනය සහ VAT අංකය ඇතුළත් වන පරිදි ඔබගේ සමාගම් විස්තර ඇතුළත් කර ඇත (Reselling → Your company).
• ඔබ මුල සිට අග දක්වා එක් සැබෑ ඇණවුමක් තබා අඩවිය දර්ශනය වන ආකාරය නිරීක්ෂණය කර ඇත.

අනෙකුත් සියලුම දේ ඇති ස්ථානය

සම්පූර්ණ API යොමුව — අපගේ පිරිවිතරයන්ගෙන් උත්පාදනය කරන ලද, එකිනෙකට අවශ්‍ය අවසර සහිත සෑම එන්ඩ්පොයින්ට් එකක්ම — <https://zinndigital.com/developers/api> හි ඇත.