Jual hosting Zinn® dari WHMCS

Modul Zinn Digital® mengubah tombol bawaan WHMCS menjadi tindakan nyata di platform kami. Pesanan akan menyediakan hosting klien Anda. Otomatisasi tagihan jatuh tempo WHMCS akan menangguhkannya. Menandai tagihan sebagai lunas akan memulihkannya. Pembatalan akan menjadwalkan penghapusan. Dan klien Anda mendapatkan tombol Masuk ke panel hosting di area klien mereka yang langsung masuk ke akun mereka.

Modul ini gratis, berlisensi GPL-2.0-or-later, dan tidak memiliki jalur istimewa ke platform kami: setiap panggilan yang dibuatnya adalah titik akhir (endpoint) terdokumentasi yang dapat Anda buat sendiri dengan kunci API Anda sendiri.

Sebelum Anda mulai

Anda memerlukan dua hal, dan hal kedua sering kali mengecoh banyak orang.

Akun reseller Zinn® dengan program aktif. Daftar di zinndigital.com dan aktifkan fitur reselling.
Paket reseller dengan alokasi situs. Situs yang dipesan klien Anda akan memotong kuota paket Anda, jadi Anda memerlukan paket yang memiliki sisa kuota.

⚠️ Uji Koneksi tidak dapat memberi tahu Anda apakah suatu pesanan akan berhasil. Sistem ini membaca program Anda dan tidak menyediakan apa pun, sehingga sistem melaporkan akun active yang sehat namun belum dapat menjual apa pun. Jika pesanan pertama Anda gagal dengan pesan "Organisasi ini tidak memiliki paket hosting, sehingga belum dapat menghosting situs", itulah yang terjadi — beli atau perpanjang paket reseller Anda dan buat pesanan lagi. Tidak ada yang salah dengan modul ini.

1. Membuat kunci API

Di dasbor Zinn® Anda, buka Kunci API (API keys) dan buat satu kunci dengan tepat sebelas izin berikut:

| Izin | Alasan izin tersebut diperlukan | | -------------------- | ----------------------------------------------------------- | | org.create | Membuka akun Zinn® klien Anda pada pesanan pertama mereka. | | org.read | Membaca akun klien Anda. | | sites.create | Menyediakan situs. | | sites.view | Membaca layanan dan penggunaannya. | | sites.delete | Mengakhiri layanan. | | reseller.view | Menampilkan apa yang telah Anda jual, serta membaca penggunaan disk dan bandwidth. | | reseller.provision | Menangguhkan, memulihkan, memasukkan klien ke akun, menetapkan paket mereka, dan mengubah paket mereka. | | billing.view | Membaca perkiraan biaya peningkatan sebelum melakukannya. | | sites.manage | Membersihkan cache dan membuat cadangan dari tombol. | | sites.panel_access | Mengubah kata sandi administrator WordPress. | | hosting.php.manage | Mengalihkan versi PHP saat melakukan peningkatan atau penurunan. |

⛔ Jangan berikan izin reseller.manage. Kunci yang ditempelkan di panel penagihan harus dapat menangguhkan klien karena non-pembayaran dan memasukkan mereka ke akun. Kunci tersebut tidak boleh dapat membaca dan menulis ulang kredensial gateway pembayaran Anda sendiri. reseller.provision ada agar Anda tidak perlu memberikan izin yang lebih tinggi. ⛔ org.create wajib diisi. Tanpa izin ini, modul dapat membaca akun Anda tetapi tidak dapat membukanya, sehingga Uji Koneksi berhasil tetapi pesanan pertama merespons dengan kesalahan 403. ⛔⛔ Berikan izin untuk seluruh tabel, dan perlu diingat bahwa Uji Koneksi tidak dapat memberi tahu Anda jika Anda belum melakukannya. Sistem ini membaca program reseller Anda dan tidak menyediakan apa pun, sehingga statusnya tetap hijau meskipun kunci kehilangan salah satu dari izin tersebut. Sebagai gantinya, yang akan Anda dapatkan adalah kesalahan 403 pada satu operasi yang dicakup oleh izin yang hilang tersebut, beberapa bulan kemudian, dari pelanggan.

2. Memasang modul

Unduh modul dan ekstrak file zip-nya.
Unggah direktori zinn ke instalasi WHMCS Anda sehingga file modul berada di modules/servers/zinn/zinn.php.

⛔ Direktori tersebut harus bernama zinn. WHMCS menurunkan nama fungsi modul penyediaan dari nama direktorinya, sehingga mengubah namanya menjadi zinn-whmcs atau zinndigital akan menghasilkan modul yang dicantumkan WHMCS, memungkinkan Anda memilihnya, tetapi tidak akan pernah memanggilnya — tanpa ada pesan error di mana pun. File zip tersebut sudah diekstrak dengan nama yang benar; cukup jangan ubah namanya.

3. Menambahkan server

Di WHMCS: Konfigurasi → Pengaturan Sistem → Server → Tambahkan Server Baru (Configuration → System Settings → Servers → Add New Server).

Nama: apa saja, mis. Zinn Digital®
Nama Host: api.zinndigital.com
Tipe: Zinn Digital®
Kata Sandi: kunci API Anda dari langkah 1

⛔ Kunci tersebut dimasukkan ke dalam kolom Kata Sandi (Password), yang disimpan secara terenkripsi oleh WHMCS. Jangan masukkan kunci tersebut ke dalam opsi konfigurasi produk — karena opsi tersebut berupa teks biasa di dalam database dan dapat dilihat oleh setiap admin, dan kredensial ini dapat membuat serta menghapus hosting klien Anda.

Tekan Uji Koneksi (Test Connection). Tombol ini melakukan panggilan nyata dan melaporkan apa yang dikatakan platform kami, alih-alih sekadar memeriksa apakah kolom-kolom telah diisi.

4. Membuat produk

Konfigurasi → Pengaturan Sistem → Produk/Layanan (Configuration → System Settings → Products/Services), lalu tetapkan Pengaturan Modul (Module Settings) ke server yang baru saja Anda tambahkan. Kolom-kolomnya adalah:

| Kolom | Wajib | Keterangan | | ---------------- | -------- | -------------------------------------------------------------------------- | | Lini produk | ya | Lini Zinn® yang Anda jual — mainstream (WordPress terkelola), footprint_free, wordpress, linux, cloud, agency, app_hosting, ai_hosting, lms_hosting, managed_database, vector_hosting, zinn_compute, fleet_linux, fleet_enterprise, mail, atau reseller. | | Stack | ya | Apa yang dibangun: wordpress (bawaan), woocommerce, php, static, node, one_click, headless_cms, nextcloud, atau owncloud. | | Aplikasi | tidak | Hanya untuk stack one_click dan headless_cms — aplikasi mana yang akan dipasang. Menyebutkan aplikasi pada stack lain akan ditolak, karena stack tersebut sudah menentukan apa yang akan dipasang. | | Versi PHP | tidak | mis. 8.3. Biarkan kosong untuk menggunakan versi bawaan lini tersebut. Versi yang tidak ditawarkan oleh lini tersebut akan ditolak bersama dengan daftar versi yang didukungnya. | | Kode paket | ya | Paket Zinn® yang dijual produk ini. GET /v1/reseller/prices mencantumkan paket Anda. Pesanan tanpa kode ini akan ditolak — lihat peringatan di bawah. | | Interval penagihan | tidak | monthly (bawaan) atau annual — interval waktu lini grosir Anda untuk klien ini ditagihkan. Biaya yang Anda tetapkan ke klien Anda sendiri diatur pada produk WHMCS dan tidak akan terpengaruh. |

⛔⛔ Kode paket wajib diisi, dan pesanan tanpa kode paket akan ditolak secara sengaja. Hingga 2026-09-01, kolom ini bersifat dekoratif dan tidak ada yang membacanya, sehingga modul memesan hosting yang tidak membawa paket apa pun — dan setiap konsekuensi dari hal tersebut terjadi secara senyap. Laporan grosir Anda dibuat dari langganan aktif klien Anda, sehingga tidak ada baris untuk layanan tersebut dan Anda tidak ditagih apa pun selama layanan itu berjalan; klien Anda tidak mewarisi alokasi apa pun, sehingga tidak ada kuota disk atau file yang diterapkan ke situs mereka; dan Ubah Paket tidak memiliki hal untuk diubah, sehingga peningkatan layanan yang Anda jual tidak dapat dilakukan. Situs tersebut tetap disediakan dan berfungsi dengan sempurna sepanjang waktu.

Modul kini menolak pesanan sebagai gantinya, karena tidak ada paket aman yang dapat ditebaknya: tebakan akan menghasilkan penyediaan hosting pada paket yang tidak Anda pilih dan mungkin belum Anda beri harga, dan — tidak seperti penolakan yang langsung Anda baca — hal tersebut baru akan terlihat saat laporan tagihan tiba, itu pun jika ada.

Atur Pengaturan Otomatis (Auto Setup) ke opsi yang Anda inginkan — modul ini bersifat idempoten pada ID layanan WHMCS, sehingga penyediaan yang dicoba ulang akan mengembalikan situs yang sama alih-alih menagih Anda untuk situs kedua.

Fungsi setiap tindakan WHMCS

| Tindakan WHMCS | Apa yang terjadi di sisi kami | | --------------------------- | ---------------------------------------------------------------------------------------- | | Buat (Create) | Membuat akun Zinn® klien (atau menggunakan kembali akun yang sudah mereka miliki) dan menyediakan situs mereka. | | Tangguhkan (Suspend) | Menempatkan situs pada status ditahan karena non-pembayaran. Konten disimpan; tidak ada yang dihapus. | | Batalkan Penangguhan (Unsuspend) | Melepaskan status tahanan milik Anda. | | Akhiri (Terminate) | Menjadwalkan penghapusan situs, dengan masa tenggang. Tanggal tersebut akan ditampilkan di area klien. | | Pembaruan penggunaan | Memperbarui disk dan bandwidth pada setiap layanan, sekali sehari. | | Masuk ke panel hosting | Membuka tautan masuk sekali pakai yang langsung mengarah ke panel klien Anda. | | Ubah Paket | Meningkatkan atau menurunkan versi layanan. Memindahkan paket, serta versi PHP jika produk baru menentukannya. | | Ubah Kata Sandi | Mengatur kata sandi administrator WordPress. Kotak ini tidak muncul pada stack yang tidak memiliki akun semacam itu. | | Perpanjang | Mengonfirmasi bahwa layanan masih ada. Hosting Zinn® bersifat berkelanjutan, jadi tidak ada jangka waktu jarak jauh yang perlu diperpanjang. | | Sinkronkan Penggunaan / Bersihkan Cache / Buat Cadangan | Tombol-tombol pada halaman layanan admin. Klien Anda mendapatkan tombol Bersihkan Cache dan Buat Cadangan di area klien mereka. | | Tab layanan | Status, paket, disk, bandwidth, jadwal penghapusan (jika ada), dan siapa yang melakukan penangguhan. | | Impor | ListAccounts membaca setiap halaman, sehingga proses impor tidak dapat berhenti secara senyap pada halaman pertama. |

Peningkatan: siapa menagih siapa

Klien Anda tidak pernah ditagih oleh Zinn®, baik untuk pesanan maupun peningkatan layanan. Anda menagih mereka melalui WHMCS; kami menagih Anda melalui laporan grosir Anda. Oleh karena itu, Ubah Paket memindahkan hak klien Anda dan baris pada laporan tagihan Anda berikutnya, serta tidak menyentuh kartu kredit apa pun — WHMCS telah mengambil uang klien Anda dan menghitung proratanya sendiri.

Layanan kedua klien. Pada paket yang sama, ini adalah situs lain di bawah alokasi situs paket tersebut, dan tidak ada tambahan kuota yang diberikan. Pada paket yang berbeda, permintaan akan ditolak: mengganti paket yang sedang aktif akan membuat salah satu dari dua layanan tidak tertagih. Anda dapat menjual keduanya pada paket yang sama, atau menyiapkan klien tersebut sebagai catatan klien terpisah di WHMCS.

Ubah Kata Sandi hanya ada untuk WordPress. Hosting Zinn® tidak memiliki "kata sandi layanan" tunggal — klien Anda mengakses panel mereka menggunakan tombol masuk — dan situs php atau static tidak memiliki akun aplikasi untuk diubah. WHMCS menyembunyikan kotak tersebut sepenuhnya alih-alih menampilkan kotak yang tidak dapat berfungsi.

Tiga jawaban yang tidak boleh Anda samaratakan menjadi dua

Batalkan Penangguhan dapat merespons dengan penolakan. Itu berarti situs ditangguhkan oleh tim penyalahgunaan (abuse) kami, bukan oleh Anda, dan panel penagihan mana pun tidak boleh memulihkannya. Pesan tersebut menyatakan demikian; tunjukkan pesan tersebut kepada admin Anda alih-alih mencoba ulang.
Akhiri menjadwalkan penghapusan, bukan melakukannya. Tanggal tersebut dikembalikan sebagai pending_deletion_at dan area klien akan menampilkannya. Memberitahu pelanggan bahwa data mereka sudah hilang padahal sebenarnya belum jauh lebih buruk daripada tidak memberitahu mereka sama sekali.
Disk dan bandwidth bisa bernilai tidak diketahui, dan tidak diketahui bukanlah nol. Ketika kami tidak dapat mengambil pembacaan, modul akan membiarkan angka tersebut apa adanya alih-alih menuliskan 0 — jika tidak, WHMCS akan menampilkan bilah penggunaan kosong yang menenangkan kepada pelanggan Anda untuk situs yang tidak memiliki pembacaan dari kami.

Pemecahan Masalah

Uji Koneksi berhasil tetapi pesanan pertama gagal dengan error izin. Kunci API kehilangan izin org.create. Modul harus membuka akun klien sebelum dapat membuat situs mereka.

Pesanan gagal dengan pesan bahwa organisasi tidak memiliki paket hosting. Paket reseller Anda tidak memiliki sisa alokasi situs, atau Anda belum memilikinya. Lihat bagian Sebelum Anda mulai di atas.

Pesanan gagal dengan menyebutkan stack. Kolom Stack pada produk kosong atau menyebutkan sesuatu yang tidak kami bangun. Atur ke wordpress kecuali Anda menjual produk lain.

Pembatalan gagal. Pastikan Anda menggunakan modul versi 1.0.0 atau yang lebih baru. Versi sebelumnya tidak mengirimkan konfirmasi penghapusan dan setiap pengakhiran layanan ditolak, yang membuat layanan tetap berjalan dan tertagih.

Penolakan yang menyebutkan suatu kolom. Error validasi kami menyebutkan kolom dan alasannya di dalam tanda kurung setelah pesan, mis. (php_version: 7.2 is not offered on this product line). Itulah bagian yang dapat ditindaklanjuti — kalimat di depannya sengaja dibuat bersifat umum.

Verifikasi unduhan Anda

Setiap arsip disajikan melalui TLS dari nama host kami sendiri dan tidak pernah dialihkan ke host pihak ketiga. Checksum SHA-256 dicantumkan di sebelah tautan unduhan pada halaman unduhan. Bandingkan setelah mengunduh:

macOS atau Linux: shasum -a 256 zinn-whmcs-1.0.0.zip
Windows: certutil -hashfile zinn-whmcs-1.0.0.zip SHA256

Tidak menggunakan WHMCS?

Terdapat modul HostBill dan klien PHP file tunggal untuk hal lainnya, keduanya gratis dan tersedia di halaman unduhan yang sama. Setiap titik akhir yang digunakan oleh modul-modul tersebut ada di referensi API.