ඔබගේම පද්ධති වලින් Zinn® සත්කාරකත්වය විකිණීම

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

ඔබේ ගනුදෙනුකරුවන්ට සැබවින්ම පෙනෙන දේ

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

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

ඔබ පැනල ධාරක නාමයක් සැකසූ පසු, එය WordPress ප්ලගිනයේ පැනල ලිපිනය ක්ෂේත්‍රයෙහි පමණක් ඇතුළත් කරන්න — මෙම API මඟින් ජනනය කරන පුරනය වීමේ සබැඳි ස්වයංක්‍රීයව එය අනුගමනය කරයි.

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

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

1. API යතුරක් ලබා ගන්න

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

⛔ ඒකාබද්ධ කිරීමකට reseller.manage ලබා නොදෙන්න. එම අවසරය මඟින් ඔබේ මිල ලැයිස්තුව සහ ඔබේම ගෙවීම් ද්වාර අක්තපත්‍ර සංස්කරණය කරයි. බිල්පත් පැනලයකට හෝ වෙබ් අඩවියකට ඔබ අලවන යතුරකට එය අවශ්‍ය නොවන පරිදි 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

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

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

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

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

4. ගනුදෙනුකරුවෙකු පුරනය කරවීම

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

⛔ ඔවුන් ක්ලික් කළ විට එය ජනනය කරන්න, කිසි විටෙකත් ඔබ පිටුව සකසන (render) විට නොවේ. සබැඳිය තනි භාවිත වන අතර මිනිත්තු කිහිපයක් ඇතුළත කල් ඉකුත් වේ, එබැවින් පිටුවක ලියා ඇති සබැඳියක් පළමු පිටු දර්ශනයේදී දහනය වන අතර ඔබ සහ බ්‍රවුසරය අතර ඇති සෑම හැඹිලියකම (cache) ඉතිරි වේ.

5. ඒ වෙනුවට මොඩියුලයක් ස්ථාපනය කරන්න

• WHMCS — මොඩියුලය modules/servers/zinn/ වෙත පිටපත් කරන්න, මුරපදය ඔබේ API යතුර වන සේවාදායකයක් එක් කරන්න, සහ නිෂ්පාදනය මත නිෂ්පාදන පෙළ සකසන්න. සම්බන්ධතාව පරීක්ෂා කරන්න ඔබන්න: එය සැබෑ ඇමතුමක් ලබා දෙන අතර වේදිකාව පැවසූ දේ ඔබට දන්වයි.
• HostBill — includes/modules/Hosting/zinn/ වෙත පිටපත් කර එම ආකාරයෙන්ම සම්බන්ධ කරන්න.
• WordPress — Zinn® Reseller Toolkit: වසම් සෙවීම, ඔබේ ගනුදෙනුකරුවන්ගේ සත්කාරක සේවාවට පුරනය වීමේ සබැඳියක්, සහ ඇණවුමක් ගෙවූ විට WooCommerce සැපයීම. <https://github.com/Zinn-Digital/zinn-reseller-toolkit> හි විවෘත මූලාශ්‍ර ලෙස ඇත, නැතහොත් ඔබේ උපකරණ පුවරුවේ ඇති ප්ලගින වෙතින් එය බාගන්න.

6. සජීවීව ආරම්භ කරන්න

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

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

අනෙක් සියල්ල ඇති තැන

සම්පූර්ණ API පරිශීලන මාර්ගෝපදේශය — අපගේ පිරිවිතරයෙන් ජනනය කරන ලද, ඒ සෑම එකකටම අවශ්‍ය අවසරය සහිත සෑම අන්ත ලක්ෂ්‍යයක්ම (endpoint) — <https://zinndigital.com/developers/api> හි ඇත.