ขายโฮสติ้ง Zinn® จาก WHMCS

โมดูล Zinn Digital® เปลี่ยนปุ่มของ WHMCS ให้เป็นการกระทำจริงบนแพลตฟอร์มของเรา คำสั่งซื้อจะทำการจัดเตรียมโฮสติ้งของลูกค้าของคุณ การทำงานอัตโนมัติเมื่อใบแจ้งหนี้เกินกำหนดของ WHMCS จะระงับการใช้งาน การทำเครื่องหมายว่าชำระเงินแล้วจะปลดระงับ การยกเลิกจะตั้งเวลาการลบ และลูกค้าของคุณจะได้รับปุ่ม เข้าสู่ระบบแผงควบคุมโฮสติ้ง ในพื้นที่ลูกค้า ซึ่งจะนำเข้าสู่ระบบได้ทันที

โมดูลนี้ให้บริการฟรี ใช้สัญญาอนุญาตแบบ GPL-2.0-or-later และไม่มีช่องทางพิเศษเข้าสู่แพลตฟอร์มของเรา: ทุกการเรียกใช้งานคือเอนด์พอยต์ที่มีเอกสารประกอบ ซึ่งคุณสามารถทำได้เองด้วย API key ของคุณ

ก่อนที่คุณจะเริ่มต้น

คุณต้องมีสองสิ่ง และสิ่งแวดล้อมที่สองมักทำให้ผู้คนสับสน

1. บัญชีตัวแทนจำหน่าย Zinn® พร้อมโปรแกรมที่ใช้งานอยู่ ลงทะเบียนที่ zinndigital.com และเปิดใช้งานการเป็นตัวแทนจำหน่าย
2. แผนตัวแทนจำหน่ายที่มีโควต้าเว็บไซต์ ไซต์ที่ลูกค้าของคุณสั่งซื้อจะถูกหักจากแผนของคุณ ดังนั้นคุณต้องมีแผนที่มีพื้นที่ว่างเพียงพอ

ж ทดสอบการเชื่อมต่อไม่สามารถบอกได้ว่าคำสั่งซื้อจะสำเร็จหรือไม่ ระบบจะอ่านโปรแกรมของคุณและไม่ได้จัดเตรียมสิ่งใด ดังนั้นจึงรายงานว่าบัญชีมีสถานะ active ที่ยังไม่สามารถขายอะไรได้ หากคำสั่งซื้อแรกของคุณล้มเหลวด้วยข้อความ "องค์กรนี้ไม่มีแผนโฮสติ้ง จึงยังไม่สามารถโฮสต์ไซต์ได้" นั่นคือสิ่งที่เกิดขึ้น — ซื้อหรือขยายแผนตัวแทนจำหน่ายของคุณแล้วทำการสั่งซื้ออีกครั้ง ไม่มีข้อผิดพลาดใด ๆ กับตัวหมดูล

1. สร้าง API key

ในแดชบอร์ด Zinn® ของคุณ ให้เปิด API keys และสร้างคีย์ที่มีสิทธิ์ตรงตาม สิบเอ็ด ข้อนี้:

| สิทธิ์ | ทำไมจึงจำเป็น | | -------------------- | ----------------------------------------------------------- | | org.create | เปิดบัญชี Zinn® ของลูกค้าในการสั่งซื้อครั้งแรก | | org.read | อ่านบัญชีลูกค้าของคุณ | | sites.create | จัดเตรียมเว็บไซต์ | | sites.view | อ่านบริการและการใช้งาน | | sites.delete | ยุติบริการ | | reseller.view | แสดงรายการสิ่งที่คุณขาย และอ่านดิสก์กับแบนด์วิดท์ | | reseller.provision | ระงับ ปลดระงับ ลงชื่อเข้าใช้ให้ลูกค้า กำหนดแผน และเปลี่ยนแพ็กเกจ | | billing.view | อ่านค่าใช้จ่ายในการอัปเกรดก่อนดำเนินการ | | sites.manage | ล้างแคชและสำรองข้อมูลจากปุ่มต่าง ๆ | | sites.panel_access | เปลี่ยนรหัสผ่านผู้ดูแลระบบ WordPress | | hosting.php.manage | สลับเวอร์ชัน PHP เมื่ออัปเกรดหรือดาวน์เกรด |

⛔ อย่าให้สิทธิ์ reseller.manage คีย์ที่วางในแผงการเรียกเก็บเงินควรสามารถระงับลูกค้ากรณีไม่ชำระเงินและลงชื่อเข้าใช้ให้พวกเขาได้ แต่ไม่ควรสามารถอ่านและเขียนข้อมูลรับรองเกตเวย์การชำระเงินของคุณเองได้ สิทธิ์ reseller.provision มีไว้เพื่อให้คุณไม่ต้องให้สิทธิ์ที่ใหญ่กว่า ⛔ org.create เป็นสิ่งที่ไม่ใช่ทางเลือก หากไม่มีสิทธิ์นี้ โมดูลจะสามารถอ่านบัญชีของคุณได้แต่จะไม่สามารถเปิดบัญชีใหม่ได้ ดังนั้นการทดสอบการเชื่อมต่อจึงผ่าน แต่คำสั่งซื้อแรกจะตอบกลับด้วย 403 ⛔⛔ โปรดให้สิทธิ์ทั้งตาราง และโปรดทราบว่าการทดสอบการเชื่อมต่อไม่สามารถบอกได้หากคุณไม่ได้ให้สิทธิ์ครบ ระบบจะอ่านโปรแกรมตัวแทนจำหน่ายของคุณและไม่ได้จัดเตรียมสิ่งใด ดังนั้นจึงแสดงสถานะสีเขียวสำหรับคีย์ที่ขาดสิทธิ์เหล่านี้ สิ่งที่คุณจะได้รับแทนคือข้อผิดพลาด 403 ในการดำเนินการเดียวที่สิทธิ์ที่ขาดหหายไปครอบคลุม ซึ่งจะปรากฏขึ้นหลายเดือนต่อมา จากลูกค้าจริง

2. ติดตั้งโมดูล

1. ดาวน์โหลดโมดูล และคลายซิป
2. อัปโหลดไดเรกทอรี zinn ไปยังการติดตั้ง WHMCS ของคุณเพื่อให้ไฟล์โมดูลไปอยู่ที่ modules/servers/zinn/zinn.php

⛔ ไดเรกทอรีต้องชื่อ zinn เท่านั้น WHMCS จะดึงชื่อฟังก์ชันของโมดูลการจัดเตรียมมาจากชื่อไดเรกทอรี ดังนั้นการเปลี่ยนชื่อเป็น zinn-whmcs หรือ zinndigital จะทำให้เกิดโมดูลที่ WHMCS แสดงรายการ ให้คุณเลือกได้ แต่จะไม่ทำงานเลย โดยไม่มีข้อผิดพลาดใด ๆ ปรากฏขึ้น ไฟล์ซิปจะแตกออกเป็นชื่อที่ถูกต้องอยู่แล้ว เพียงแค่ไม่ต้องเปลี่ยนชื่อ

3. เพิ่มเซิร์ฟเวอร์

ใน WHMCS: Configuration → System Settings → Servers → Add New Server

• Name: อะไรก็ได้ เช่น Zinn Digital®
• Hostname: api.zinndigital.com
• Type: Zinn Digital®
• Password: API key ของคุณจากขั้นตอนที่ 1

⛔ ใส่คีย์ลงในช่อง Password ซึ่ง WHMCS จะจัดเก็บแบบเข้ารหัส อย่าใส่ไว้ในตัวเลือกการกำหนดค่าผลิตภัณฑ์ เนื่องจากข้อมูลเหล่านั้นเป็นข้อความธรรมดาในฐานข้อมูลและผู้ดูแลระบบทุกคนมองเห็นได้ ในขณะที่ข้อมูลรับรองนี้สามารถสร้างและทำลายโฮสติ้งของลูกค้าของคุณได้

กด Test Connection ระบบจะทำการเรียกใช้งานจริงและรายงานสิ่งที่แพลตฟอร์มของเราตอบกลับ แทนที่จะเป็นเพียงการตรวจสอบว่ามีการกรอกช่องข้อมูลครบถ้วนหรือไม่

4. สร้างผลิตภัณฑ์

Configuration → System Settings → Products/Services จากนั้นตั้งค่า Module Settings เป็นเซิร์ฟเวอร์ที่คุณเพิ่งเพิ่ม ช่องข้อมูลมีดังนี้:

| ฟิลด์ | จำเป็น | รายละเอียด | | ---------------- | -------- | -------------------------------------------------------------------------- | | Product line | ใช่ | สายผลิตภัณฑ์ Zinn® ที่คุณกำลังขาย — mainstream (WordPress แบบจัดการ), footprint_free, wordpress, linux, cloud, agency, app_hosting, ai_hosting, lms_hosting, managed_database, vector_hosting, zinn_compute, fleet_linux, fleet_enterprise, mail หรือ reseller | | Stack | ใช่ | สิ่งที่จะถูกสร้างขึ้น: wordpress (ค่าเริ่มต้น), woocommerce, php, static, node, one_click, headless_cms, nextcloud หรือ owncloud | | Application | ไม่ | สำหรับสแตก one_click และ headless_cms เท่านั้น — แอปพลิเคชันที่จะติดตั้ง การระบุแอปพลิเคชันบนสแตกอื่นจะถูกปฏิเสธ เนื่องจากสแตกนั้นกำหนดสิ่งที่จะติดตั้งไว้แล้ว | | PHP version | ไม่ | เช่น 8.3 เว้นว่างไว้สำหรับค่าเริ่มต้นของสายผลิตภัณฑ์ เวอร์ชันที่สายผลิตภัณฑ์ไม่มีให้บริการจะถูกปฏิเสธพร้อมรายการเวอร์ชันที่มี | | Plan code | ใช่ | แผน Zinn® ที่ผลิตภัณฑ์นี้ขาย GET /v1/reseller/prices จะแสดงรายการของคุณ คำสั่งซื้อที่ไม่มีข้อมูลนี้จะถูกปฏิเสธ — ดูคำเตือนด้านล่าง | | Billing interval | ไม่ | monthly (ค่าเริ่มต้น) หรือ annual — รอบระยะเวลาที่สายขายส่ง ของคุณ สำหรับลูกค้ารายนี้ถูกเรียกเก็บเงิน ราคาที่คุณเรียกเก็บจากลูกค้าของคุณเองถูกกำหนดไว้บนผลิตภัณฑ์ WHMCS และไม่ได้รับผลกระทบ |

⛔⛔ Plan code เป็นสิ่งจำเป็น และคำสั่งซื้อที่ไม่มีรหัสแผนจะถูกปฏิเสธโดยเจตนา จนถึงวันที่ 2026-09-01 ฟิลด์นี้เป็นเพียงการตกแต่งและไม่มีระบบใดอ่านค่า ดังนั้นโมดูลจึงสั่งซื้อโฮสติ้งที่ ไม่มีแผนใด ๆ เลย — และทุกผลลัพธ์ที่ตามมาเกิดขึ้นโดยไม่มีการแจ้งเตือน ใบแจ้งหนี้ขายส่งของคุณสร้างขึ้นจากการสมัครสมาชิกที่ใช้งานอยู่ของลูกค้าของคุณ ดังนั้นจึงไม่มีรายการสำหรับบริการนี้และ คุณไม่ถูกเรียกเก็บเงินใด ๆ ตลอดระยะเวลาที่ใช้งาน ลูกค้าของคุณไม่ได้รับโควต้าใด ๆ ดังนั้นจึงไม่มีการกำหนดโควต้าดิสก์หรือไฟล์ให้กับเว็บไซต์ของพวกเขา และ Change Package ไม่มีอะไรให้เปลี่ยน ดังนั้นการอัปเกรดที่คุณขายจึงไม่สามารถดำเนินการได้ เว็บไซต์ได้รับการจัดเตรียมและให้บริการอย่างสมบูรณ์แบบตลอดเวลา

ตอนนี้โมดูลจะปฏิเสธคำสั่งซื้อแทน เนื่องจากไม่มีแผนที่ปลอดภัยให้คาดเดา: การเดาจะจัดเตรียมโฮสติ้งบนแผนที่คุณไม่ได้เลือกและอาจไม่ได้กำหนดราคาไว้ และต่างจากการปฏิเสธที่คุณสามารถอ่านได้ทันที การเดาจะปรากฏขึ้นเมื่อใบแจ้งหนี้มาถึงเท่านั้น หากมี

ตั้งค่า Auto Setup ตามที่คุณต้องการ — โมดูลนี้เป็นแบบ idempotent สำหรับรหัสบริการของ WHMCS ดังนั้นการจัดเตรียมที่ลองทำซ้ำจะส่งคืนเว็บไซต์เดิมแทนที่จะเรียกเก็บเงินคุณเป็นครั้งที่สอง

สิ่งที่การกระทำแต่ละอย่างของ WHMCS ทำ

| การกระทำของ WHMCS | สิ่งที่เกิดขึ้นฝั่งเรา | | --------------------------- | ---------------------------------------------------------------------------------------- | | Create | สร้างบัญชี Zinn® ของลูกค้า (หรือใช้บัญชีที่มีอยู่เดิม) และจัดเตรียมเว็บไซต์ของพวกเขา | | Suspend | พักการใช้งานเว็บไซต์เนื่องจากค้างชำระเงิน ข้อมูลยังคงอยู่ ไม่มีสิ่งใดถูกลบ | | Unsuspend | ปลดสถานะการระงับของ คุณ | | Terminate | กำหนดเวลาการลบเว็บไซต์ พร้อมช่วงเวลาผ่อนผัน วันที่จะแสดงในพื้นที่ลูกค้า | | Usage update | รีเฟรชพื้นที่ดิสก์และแบนด์วิดท์ของทุกบริการ วันละหนึ่งครั้ง | | Log in to hosting panel | เปิดลิงก์เข้าสู่ระบบแบบใช้ครั้งเดียวตรงไปยังแผงควบคุมของลูกค้าของคุณ | | Change Package | อัปเกรดหรือดาวน์เกรดบริการ ย้ายแพ็กเกจ และเวอร์ชัน PHP หากผลิตภัณฑ์ใหม่มีการระบุไว้ | | Change Password | ตั้งค่ารหัสผ่านของ ผู้ดูแลระบบ WordPress ช่องนี้จะไม่ปรากฏบนสแตกที่ไม่มีบัญชีดังกล่าว | | Renew | ยืนยันว่าบริการยังคงอยู่ โฮสติ้ง Zinn® เป็นแบบต่อเนื่อง ดังนั้นจึงไม่มีระยะเวลาบริการระยะไกลที่ต้องขยายเวลา | | Sync Usage / Purge Cache / Take Backup | ปุ่มบนหน้าบริการของผู้ดูแลระบบ ลูกค้าของคุณจะได้รับปุ่มล้างแคช (Purge Cache) และสำรองข้อมูล (Take Backup) ในพื้นที่ลูกค้าของพวกเขา | | Service tab | สถานะ, แผน, ดิสก์, แบนด์วิดท์, การกำหนดเวลาลบ และใครที่เป็นผู้ระงับบริการ | | Import | ListAccounts จะอ่านทุกหน้า ดังนั้นการนำเข้าจึงไม่สามารถหยุดกะทันหันที่หน้าแรกได้ |

การอัปเกรด: ใครเรียกเก็บเงินจากใคร

ลูกค้าของคุณจะไม่ถูกเรียกเก็บเงินจาก Zinn® ไม่ว่าจะในคำสั่งซื้อหรือการอัปเกรด คุณเรียกเก็บเงินพวกเขาผ่าน WHMCS ส่วนเราเรียกเก็บเงินจากคุณในใบแจ้งหนี้ขายส่ง ดังนั้น Change Package จะย้ายสิทธิประโยชน์ของลูกค้าและรายการในใบแจ้งหนี้รอบถัดไปของคุณ โดยไม่แตะต้องบัตรเครดิต — WHMCS ได้รับเงินจากลูกค้าและคำนวณการเฉลี่ยสัดส่วนเรียบร้อยแล้ว

บริการที่สองของลูกค้า บนแผนเดียวกัน นี่คือเว็บไซต์อื่นภายใต้โควต้าเว็บไซต์ของแผนนั้น และไม่มีการให้สิทธิ์เพิ่มเติม บนแผนที่แตกต่างกัน คำสั่งซื้อจะถูกปฏิเสธ: การแทนที่แผนที่ใช้งานอยู่จะทำให้บริการใดบริการหนึ่งไม่มีการเรียกเก็บเงิน คุณควรขายทั้งสองบริการบนแผนเดียวกัน หรือตั้งค่าลูกค้าเป็นบันทึกแผงลูกค้าแยกต่างหากใน WHMCS

Change Password มีไว้สำหรับ WordPress เท่านั้น โฮสติ้ง Zinn® ไม่มี "รหัสผ่านบริการ" เดียว — ลูกค้าของคุณเข้าถึงแผงควบคุมด้วยปุ่มเข้าสู่ระบบ — และเว็บไซต์ประเภท php หรือ static ไม่มีบัญชีแอปพลิเคชันให้เปลี่ยน WHMCS จะซ่อนช่องนี้ไปเลยแทนที่จะแสดงช่องที่ไม่สามารถทำงานได้

สามคำตอบที่คุณต้องไม่รวมเป็นสอง

• Unsuspend สามารถตอบกลับด้วยการปฏิเสธได้ นั่นหมายความว่าเว็บไซต์ถูกระงับโดยทีมงานตรวจสอบการละเมิดของเรา ไม่ใช่โดยคุณ และไม่มีแผงเรียกเก็บเงินใดสามารถปลดระงับได้ ข้อความจะระบุไว้อย่างชัดเจน โปรดแสดงข้อความนั้นให้ผู้ดูแลระบบของคุณดูแทนที่จะพยายามทำซ้ำ
• Terminate เป็นการตั้งเวลาลบ ไม่ใช่การดำเนินการทันที วันที่ที่ส่งกลับคือ pending_deletion_at และพื้นที่ลูกค้าจะแสดงให้เห็น การบอกลูกค้าว่าข้อมูลของพวกเขาหายไปแล้วทั้งที่จริงยังอยู่แย่ยิ่งกว่าการไม่บอกอะไรเลย
• ดิสก์และแบนด์วิดท์อาจไม่ทราบค่า และไม่ทราบค่าไม่ได้หมายความว่าเป็นศูนย์ เมื่อเราไม่สามารถอ่านค่าได้ โมดูลจะคงตัวเลขนั้นไว้แทนที่จะเขียนว่า 0 — มิฉะนั้น WHMCS จะแสดงแถบการใช้งานที่ว่างเปล่าซึ่งดูเหมือนปกติให้ลูกค้าของคุณเห็นสำหรับเว็บไซต์ที่เราไม่สามารถอ่านค่าได้

การแก้ไขปัญหา

การทดสอบการเชื่อมต่อผ่าน แต่คำสั่งซื้อแรก ล้มเหลวด้วยข้อผิดพลาดเรื่องสิทธิ์ API key ขาดสิทธิ์ org.create โมดูลจำเป็นต้องเปิดบัญชีของลูกค้าก่อนจึงจะสามารถสร้างเว็บไซต์ของพวกเขาได้

คำสั่งซื้อล้มเหลวโดยระบุว่าองค์กรไม่มีแผนโฮสติ้ง แผนตัวแทนจำหน่ายของคุณไม่มีโควต้าเว็บไซต์เหลืออยู่ หรือคุณยังไม่มีแผนดังกล่าว โปรดดูหัวข้อ ก่อนที่คุณจะเริ่มต้น ด้านบน

คำสั่งซื้อล้มเหลวโดยมีการกล่าวถึงสแตก ฟิลด์ Stack บนผลิตภัณฑ์ว่างเปล่าหรือระบุสิ่งที่เราไม่ได้สร้างขึ้น ตั้งค่าเป็น wordpress เว้นแต่คุณจะขายบริการอื่น

การยกเลิกไม่สำเร็จ โปรดตรวจสอบให้แน่ใจว่าคุณใช้โมดูลเวอร์ชัน 1.0.0 หรือใหม่กว่า เวอร์ชันก่อนหน้านี้ไม่ได้ส่งการยืนยันการลบและทุกการยุติบริการจึงถูกปฏิเสธ ซึ่งทำให้บริการยังคงทำงานและถูกเรียกเก็บเงินต่อไป

การปฏิเสธที่ระบุชื่อฟิลด์ ข้อผิดพลาดในการตรวจสอบความถูกต้องของเราจะระบุชื่อฟิลด์และเหตุผลไว้ในวงเล็บหลังข้อความ เช่น (php_version: 7.2 is not offered on this product line) นั่นคือส่วนที่คุณสามารถนำไปดำเนินการได้ ส่วนประโยคที่อยู่ด้านหน้าถูกออกแบบให้เป็นข้อความทั่วไปโดยเจตนา

ตรวจสอบการดาวน์โหลดของคุณ

ทุกไฟล์เก็บถาวรให้บริการผ่าน TLS จากโฮสต์ของเราเองและไม่มีการเปลี่ยนเส้นทางไปยังโฮสต์ของบุคคลที่สาม ค่าเช็คซัม SHA-256 จะแสดงอยู่ถัดจากลิงก์ดาวน์โหลดบน หน้าดาวน์โหลด โปรดเปรียบเทียบหลังจากการดาวน์โหลด:

• macOS หรือ Linux: shasum -a 256 zinn-whmcs-1.0.0.zip
• Windows: certutil -hashfile zinn-whmcs-1.0.0.zip SHA256

ไม่ได้ใช้ WHMCS หรือ?

เรามีโมดูลสำหรับ HostBill และไคลเอนต์ PHP แบบไฟล์เดี่ยวสำหรับระบบอื่น ๆ ซึ่งให้บริการฟรีทั้งคู่และอยู่บน หน้าดาวน์โหลด เดียวกัน ทุกเอนด์พอยต์ที่โมดูลใช้งานอยู่ใน คู่มืออ้างอิง API