Magbenta ng Zinn® hosting mula sa WHMCS

Ang Zinn Digital® module ay ginagawang mga tunay na aksyon sa aming platform ang sariling mga button ng WHMCS. Ang isang order ay naglalaan ng hosting ng iyong kliyente. Ang awtomatiko para sa overdue na invoice ng WHMCS ay nagsususpinde nito. Ang pagmamarka sa invoice bilang bayad ay naglalabas nito. Ang pagkansela ay nagtatakda ng pagtanggal. At ang iyong kliyente ay nakakakuha ng button na Log in to hosting panel sa kanilang lugar ng kliyente na direktang nag-sign in sa kanila.

Ito ay libre, may lisensyang GPL-2.0-or-later, at walang pribilehiyong landas patungo sa aming platform: ang bawat tawag na ginagawa nito ay isang dokumentadong endpoint na maaari mong gawin nang mag-isa gamit ang iyong sariling API key.

Bago ka magsimula

Kailangan mo ng dalawang bagay, at ang pangalawa ang nagpapahirap sa mga tao.

Isang Zinn® reseller account na may aktibong programa. Mag-sign up sa zinndigital.com at i-on ang pag-resell.
Isang reseller plan na may laang-lugar para sa mga site. Ang mga site na inorder ng iyong mga kliyente ay ibabawas sa iyong plan, kaya kailangan mo ng may sapat na espasyo.

⚠️ Hindi masabi ng Test Connection kung magiging matagumpay ang isang order. Binabasa nito ang iyong programa at walang inilalaan, kaya nag-uulat ito ng malusog na active account na hindi pa maaaring magbenta ng anuman. Kung ang iyong unang order ay nabigo sa pamamagitan ng "This organization has no hosting plan, so it cannot host a site yet", iyon ang nangyari — bumili o palawigin ang iyong reseller plan at i-order muli. Walang mali sa module.

1. Gumawa ng API key

Sa iyong Zinn® dashboard, buksan ang API keys at gumawa ng isa na may eksaktong labing-isang pahintulot na ito:

| Pahintulot | Bakit ito kailangan | | -------------------- | ----------------------------------------------------------- | | org.create | Buksan ang Zinn® account ng iyong kliyente sa kanilang unang order. | | org.read | Basahin ang mga account ng iyong kliyente. | | sites.create | Laanan ang site. | | sites.view | Basahin ang isang serbisyo at ang paggamit nito. | | sites.delete | I-terminate. | | reseller.view | Ilista ang iyong naibenta, at basahin ang disk at bandwidth. | | reseller.provision | Isuspinde, ilabas, i-sign in ang kliyente, itakda ang kanilang plan at baguhin ang kanilang package. | | billing.view | Basahin ang magiging halaga ng pag-upgrade bago ito isagawa. | | sites.manage | I-purge ang cache at kumuha ng backup mula sa mga button. | | sites.panel_access | Baguhin ang password ng administrator ng WordPress. | | hosting.php.manage | Lumipat ng bersyon ng PHP sa isang pag-upgrade o pag-downgrade. |

⛔ Huwag ibigay ang reseller.manage. Ang isang key na Idinikit sa billing panel ay dapat na makapigil sa isang kliyente dahil sa hindi pagbabayad at makapag-sign in sa kanila. Hindi ito dapat makabasa at makapagsulat muli ng iyong sariling mga kredensyal ng payment-gateway. Umiiral ang reseller.provision upang hindi mo na kailangang ibigay ang mas malaki. ⛔ Ang org.create ay hindi opsyonal. Kung wala ito, mababasa ng module ang iyong mga account ngunit hindi ito makakapagbukas ng isa, kaya pumapasa ang Test Connection at ang unang order ay tumutugon ng 403. ⛔⛔ Ibigay ang buong talahanayan, at tandaan na hindi masabi ng Test Connection kung hindi mo ito ginawa. Binabasa nito ang iyong reseller program at walang inilalaan, kaya berde ito para sa isang key na nawawala ang anuman sa mga ito. Ang makukuha mo sa halip ay isang 403 sa nag-iisang operasyon na saklaw ng nawawalang pahintulot, makalipas ang mga buwan, mula sa isang customer.

2. I-install ang module

I-download ang module at i-unzip ito.
I-upload ang zinn directory sa iyong pag-install ng WHMCS upang mapunta ang file ng module sa modules/servers/zinn/zinn.php.

⛔ Ang directory ay dapat na pinangalanang zinn. Hinango ng WHMCS ang mga pangalan ng function ng isang provisioning module mula sa pangalan ng directory nito, kaya ang pagpapalit ng pangalan nito sa zinn-whmcs o zinndigital ay gumagawa ng isang module na inililista ng WHMCS, hinahayaan kang piliin, at pagkatapos ay hindi kailanman tinatawag — nang walang anumang error saanman. Ang zip ay na-unpack na sa tamang pangalan; huwag lamang itong palitan ng pangalan.

3. Idagdag ang server

Sa WHMCS: Configuration → System Settings → Servers → Add New Server.

Name: kahit ano, hal. Zinn Digital®
Hostname: api.zinndigital.com
Type: Zinn Digital®
Password: ang iyong API key mula sa hakbang 1

⛔ Napupunta ang key sa field na Password, na nakaimbak nang naka-encrypt ng WHMCS. Huwag itong ilagay sa isang opsyon sa configuration ng produkto — ang mga iyon ay plain text sa database at nakikita ng bawat admin, at ang kredensyal na ito ay maaaring lumikha at sumira sa hosting ng iyong mga kliyente.

Pindutin ang Test Connection. Gumagawa ito ng tunay na tawag at nag-uulat kung ano ang sinabi ng aming platform, sa halip na suriin kung napunan ang mga field.

4. Gumawa ng produkto

Configuration → System Settings → Products/Services, pagkatapos ay itakda ang Module Settings sa server na idinagdag mo lamang. Ang mga field ay:

| Field | Kailangan | Ano ito | | ---------------- | -------- | -------------------------------------------------------------------------- | | Product line | oo | Ang Zinn® line na iyong ibinebenta — mainstream (managed WordPress), footprint_free, wordpress, linux, cloud, agency, app_hosting, ai_hosting, lms_hosting, managed_database, vector_hosting, zinn_compute, fleet_linux, fleet_enterprise, mail o reseller. | | Stack | oo | Ang binuo: wordpress (default), woocommerce, php, static, node, one_click, headless_cms, nextcloud o owncloud. | | Application | hindi | Para lamang sa mga stack na one_click at headless_cms — kung aling application ang i-install. Ang pagpapangalan sa isa sa anumang iba pang stack ay tinatanggihan, dahil pinapasya na ng stack na iyon kung ano ang ipa-install. | | PHP version | hindi | hal. 8.3. Iwanang blangko para sa default ng line. Ang isang bersyon na hindi inaalok ng line ay tinatanggihan kasama ng listahan ng mga inaalok nito. | | Plan code | oo | Ang Zinn® plan na ibinebenta ng produktong ito. Inililista ng GET /v1/reseller/prices ang sa iyo. Ang isang order na wala nito ay tinatanggihan — tingnan ang babala sa ibaba. | | Billing interval | hindi | monthly (default) o annual — ang pagitan kung kailan sinisingil ang iyong wholesale line para sa kliyenteng ito. Ang sinisingil mo sa iyong sariling kliyente ay nakatakda sa produkto ng WHMCS at hindi naaapektuhan. |

⛔⛔ Kailangan ang Plan code, at ang isang order na walang nito ay sadyang tinatanggihan. Hanggang 2026-09-01, ang field ay pampalamuti at walang nagbasa nito, kaya umorder ang module ng hosting na walang dalang plan — at ang bawat kahihinatnan nito ay tahimik. Ang iyong wholesale statement ay binuo mula sa mga live subscription ng iyong kliyente, kaya walang linya para sa serbisyo at wala kang siningil hangga't ito ay tumatakbo; ang iyong kliyente ay walang minanang laang-lugar, kaya walang quota sa disk o file ang inilapat sa kanilang site; at ang Change Package ay walang mababago, kaya ang isang pag-upgrade na iyong ibinenta ay hindi maisasagawa. Ang site ay inilaan at perpektong nagsilbi sa kabuuan.

Tinatanggihan na ngayon ng module ang order sa halip, dahil walang ligtas na plan para hulaan nito: ang isang hula ay maglalaan ng hosting sa isang plan na hindi mo pinili at maaaring hindi mo presyuhan, at — hindi tulad ng pagtanggi, na nababasa mo kaagad — lilitaw lamang ito kapag dumating ang isang statement, kung mayroon man.

Itakda ang Auto Setup sa alinman ang gusto mo — ang module ay idempotent sa id ng serbisyo ng WHMCS, kaya ang isang naka-retry na paglalaan ay nagbabalik ng parehong site sa halip na singilin ka para sa pangalawa.

Ano ang ginagawa ng bawat aksyon sa WHMCS

| Aksyon sa WHMCS | Ano ang nangyari sa aming panig | | --------------------------- | ---------------------------------------------------------------------------------------- | | Create | Gumagawa ng Zinn® account ng kliyente (o ginagamit muli ang mayroon na sila) at inilalaan ang kanilang site. | | Suspend | Naglalagay ng site sa non-payment hold. Nananatili ang nilalaman; walang tinatanggal. | | Unsuspend | Pinakawalan ang iyong hold. | | Terminate | Nagtatakda ng pagtanggal ng site, na may grace period. Ang petsa ay ipinapakita sa lugar ng kliyente. | | Usage update | Binibigyang-bago ang disk at bandwidth sa bawat serbisyo, minsan sa isang araw. | | Log in to hosting panel | Nagbubukas ng minsanang, nag-iisang gamit na link sa pag-sign-in nang direkta sa panel ng iyong kliyente. | | Change Package | Nag-a-upgrade o nag-a-downgrade sa serbisyo. Inililipat ang package, at ang bersyon ng PHP kung pinangalanan ito ng bagong produkto. | | Change Password | Itinatakda ang password ng administrator ng WordPress. Ang kahon ay hindi lumilitaw sa mga stack na walang ganoong account. | | Renew | Kinukumpirma na umiiral pa rin ang serbisyo. Ang Zinn® hosting ay tuloy-tuloy, kaya walang malayong termino na palawigin. | | Sync Usage / Purge Cache / Take Backup | Mga button sa pahina ng serbisyo ng admin. Nakakakuha ang iyong kliyente ng Purge Cache at Take Backup sa kanilang lugar ng kliyente. | | Service tab | Katayuan, plan, disk, bandwidth, anumang naka-iskedyul na pagtanggal, at kung sino ang naglagay ng suspensyon. | | Import | Binabasa ng ListAccounts ang bawat pahina, kaya ang isang import ay hindi tahimik na titigil sa una. |

Mga Pag-upgrade: kung sino ang sumisingil kanino

Ang iyong kliyente ay hindi kailanman sinisingil ng Zinn®, sa isang order o sa isang pag-upgrade. Siningil mo sila sa pamamagitan ng WHMCS; sinisingil ka namin, sa iyong wholesale statement. Kaya ang Change Package ay naglilipat ng mga karapatan ng iyong kliyente at ng linya sa iyong susunod na statement, at hindi hinahawakan ang anumang card — kinuha na ng WHMCS ang pera ng iyong kliyente at kinalkula ang sarili nitong proration.

Ang pangalawang serbisyo ng isang kliyente. Sa parehong plan isa itong isa pang site sa ilalim ng sariling laang-lugar ng site ng plan na iyon, at wala nang iba pang ipinagkaloob. Sa isang magkaibang plan ito ay tinatanggihan: ang pagpapalit sa live plan ay mag-iwan sa isa sa dalawang serbisyo na hindi siningil. Alinman sa magbenta ng pareho sa parehong plan, o i-set up ang kliyente bilang mag hiwalay na rekord ng kliyente sa WHMCS.

Ang Change Password ay umiiral lamang para sa WordPress. Ang Zinn® hosting ay walang iisang "service password" — naaabot ng iyong kliyente ang kanilang panel gamit ang sign-in button — at ang isang php o static site ay walang application account na babaguhin. Itinatago ng WHMCS ang kahon nang buo sa halip na magpakita ng isa na hindi gumagana.

Tatlong sagot na hindi mo dapat pag-isahin sa dalawa

Maaaring sumagot ang Unsuspend ng pagtanggi. Nangangahulugan iyon na ang site ay nasuspinde ng aming team ng pang-aabuso, hindi mo, at walang billing panel ang maaaring maglabas nito. Sinasabi iyon ng mensahe; ipakita ito sa iyong admin sa halip na subukang muli.
Ang Terminate ay nagtatakda ng pagtanggal, hindi ito nagsasagawa ng isa. Bumabalik ang petsa bilang pending_deletion_at at ipinapakita ito ng lugar ng kliyente. Ang pagsasabi sa isang customer na wala na ang kanilang data kung hindi naman ay mas masahol pa kaysa sa walang sasabihin sa kanila.
Ang disk at bandwidth ay maaaring hindi alam, at ang hindi alam ay hindi zero. Kapag hindi kami nakakuha ng pagbabasa, iniiwan ng module ang pigura nang hindi nagsusulat ng 0 — kung hindi ay magpapakita ang WHMCS sa iyong customer ng isang nakakatiyak na blangkong bar ng paggamit para sa isang site na wala kaming pagbabasa.

Pag-troubleshoot

Pumapasa ang Test Connection at ang unang order ay nabigo sa isang error sa pahintulot. Nawawala sa API key ang org.create. Kailangang buksan ng module ang account ng kliyente bago nito malikha ang kanilang site.

Ang isang order ay nabigo na nagsasabing walang hosting plan ang organisasyon. Ang iyong reseller plan ay walang natitirang laang-lugar para sa site, o wala ka pang hawak. Tingnan ang Bago ka magsimula sa itaas.

Ang isang order ay nabigo na binabanggit ang isang stack. Ang field na Stack sa produkto ay blangko o nagpapangalan ng isang bagay na hindi namin binubuo. Itakda ito sa wordpress maliban kung nagbebenta ka ng iba.

Nabibigo ang mga pagkansela. Siguraduhing nasa bersyon 1.0.0 o mas bago ka ng module. Ang mga naunang build ay nagpadala ng walang kumpirmasyon sa pagtanggal at ang bawat pagwawakas ay tinanggihan, na nag-iwan sa serbisyo na tumatakbo at naniningil.

Isang pagtanggi na nagpapangalan sa isang field. Ang aming mga error sa pagpapatunay ay pinangalanan ang field at ang dahilan sa mga panaklong pagkatapos ng mensahe, hal. (php_version: 7.2 is not offered on this product line). Iyon ang naaaksyunang kalahati — ang pangungusap sa harap nito ay sadyang generic.

I-verify ang iyong pag-download

Ang bawat archive ay inihahatid sa pamamagitan ng TLS mula sa aming sariling hostname at hindi kailanman nire-redirect sa isang third-party host. Ang SHA-256 checksum nito ay nakalimbag sa tabi ng link ng pag-download sa pahina ng mga pag-download. Ihambing ito pagkatapos mag-download:

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

Wala sa WHMCS?

Mayroong HostBill module at isang iisang file na PHP client para sa anupaman, parehong libre at pareho sa parehong pahina ng mga pag-download. Ang bawat endpoint na ginagamit ng mga module ay nasa API reference.