Proávejte hosting Zinn® přes WHMCS

Modul Zinn Digital® převádí vlastní tlačítka WHMCS na skutečné akce na naší platformě. Objednávka zajistí zřízení hostingu pro vašeho klienta. Automatizace po splatnosti faktur ve WHMCS jej pozastaví. Označení faktury jako zaplacené ji uvolní. Zrušení naplánuje smazání. A váš klient získá ve své klientské zóně tlačítko Přihlásit se do panelu hostingu, které ho přihlásí přímo.

Je zdarma, licencovaný pod GPL-2.0-or-later a nemá žádnou privilegovanou cestu do naší platformy: každé volání, které provádí, je zdokumentovaným koncovým bodem, který byste mohli provést sami pomocí vlastního klíče API.

Než začnete

Potřebujete dvě věci, přičemž tou druhou se lidé často spletou.

Partnerský (reseller) účet Zinn® s aktivním programem. Zaregistrujte se na zinndigital.com a zapněte přeprodej.
Partnerský program s povoleným počtem webů. Weby, které vaši klienti objednají, se počítají do vašeho tarifu, takže potřebujete takový, který má pro ně dostatečnou kapacitu.

⚠️ Test připojení nedokáže určit, zda bude objednávka úspěšná. Přečte váš program a nic nezřizuje, takže hlásí v pořádku active účet, který ještě nemůže nic prodávat. Pokud vaše první objednávka selže s chybou "Tato organizace nemá žádný hostingový tarif, takže ještě nemůže hostovat web", stalo se přesně toto — zakupte nebo prodlužte svůj partnerský tarif a odešlete objednávku znovu. S modulem není nic v nepořádku.

1. Vytvoření klíče API

Ve svém řídicím panelu Zinn® otevřete Klíče API a vytvořte jeden s přesně těmito jedenácti oprávněními:

| Oprávnění | K čemu je potřeba | | -------------------- | ----------------------------------------------------------- | | org.create | Otevření účtu Zinn® vašeho klienta při jeho první objednávce. | | org.read | Čtení účtů vašich klientů. | | sites.create | Zřízení webu. | | sites.view | Čtení služby a jejího využití. | | sites.delete | Zrušení. | | reseller.view | Zobrazení seznamu prodaných položek a čtení disku a šířky pásma. | | reseller.provision | Pozastavení, uvolnění, přihlášení klienta, nastavení jeho tarifu a změna balíčku. | | billing.view | Zjištění nákladů na upgrade před jeho provedením. | | sites.manage | Vymazání mezipaměti a vytvoření zálohy pomocí tlačítek. | | sites.panel_access | Změna hesla správce WordPress. | | hosting.php.manage | Přepnutí verze PHP při upgradu nebo downgradu. |

⛔ Neudělujte oprávnění reseller.manage. Klíč vložený do fakturačního panelu by měl dokázat pozastavit klienta kvůli nezaplacení a přihlásit ho. Neměl by však mít možnost číst a přepisovat pověření vaší vlastní platební brány. Oprávnění reseller.provision existuje proto, abyste nemuseli udělovat to širší. ⛔ org.create není volitelné. Bez něj může modul vaše účty číst, ale nemůže žádný otevřít, takže test připojení projde, ale první objednávka odpoví chybou 403. ⛔⛔ Udělte celou tabulku a mějte na paměti, že test připojení nepozná, pokud jste tak neučinili. Přečte váš partnerský program a nic nezřizuje, takže se u klíče, kterému chybí některá z těchto položek, zobrazí zeleně. Namísto toho obdržíte chybu 403 u jediné operace, kterou chybějící oprávnění pokrývá, a to o měsíce později od zákazníka.

2. Instalace modulu

Stáhněte si modul a rozbalte jej.
Nahrajte adresář zinn do své instalace WHMCS tak, aby soubor modulu skončil v umístění modules/servers/zinn/zinn.php.

⛔ Adresář se musí jmenovat zinn. WHMCS odvozuje názvy funkcí zřizovacího modulu od názvu jeho adresáře, takže jeho přejmenování na zinn-whmcs nebo zinndigital vytvoří modul, který WHMCS sice zobrazí a umožní vám jej vybrat, ale nikdy jej nezavolá — a to bez jakékoliv chybové hlášky. Archiv zip se již rozbaluje pod správným názvem, pouze jej nepřejmenovávejte.

3. Přidání serveru

Ve WHMCS: Konfigurace → Nastavení systému → Servery → Přidat nový server.

Název: libovolný, např. Zinn Digital®
Název hostitele: api.zinndigital.com
Typ: Zinn Digital®
Heslo: váš klíč API z 1. kroku

⛔ Klíč se vkládá do pole Heslo, které WHMCS ukládá v zašifrované podobě. Nevkládejte jej do konfiguračních možností produktu — ty jsou v databázi uloženy jako prostý text a jsou viditelné pro každého správce, přičemž toto pověření může vytvářet a mazat hosting vašich klientů.

Stiskněte Test připojení. Provede skutečné volání a nahlásí odpověď naší platformy, namísto pouhé kontroly, zda jsou pole vyplněná.

4. Vytvoření produktu

Konfigurace → Nastavení systému → Produkty/Služby, poté nastavte Nastavení modulu na server, který jste právě přidali. Pole jsou následující:

| Pole | Vyžadováno | Co to je | | ---------------- | ---------- | -------------------------------------------------------------------------- | | Produktová řada | ano | Řada Zinn®, kterou prodáváte — mainstream (spravovaný WordPress), footprint_free, wordpress, linux, cloud, agency, app_hosting, ai_hosting, lms_hosting, managed_database, vector_hosting, zinn_compute, fleet_linux, fleet_enterprise, mail nebo reseller. | | Zásobník (Stack) | ano | Co se vytváří: wordpress (výchozí), woocommerce, php, static, node, one_click, headless_cms, nextcloud nebo owncloud. | | Aplikace | ne | Pouze pro zásobníky one_click a headless_cms — jaká aplikace se má nainstalovat. Určení aplikace u jakéhokoli jiného zásobníku bude odmítnuto, protože daný zásobník již sám určuje, co se instaluje. | | Verze PHP | ne | např. 8.3. Ponechte prázdné pro výchozí verzi řady. Verze, kterou řada nenabízí, je odmítnuta spolu se seznamem těch, které nabízí. | | Kód tarifu | ano | Tarif Zinn®, který tento produkt prodává. GET /v1/reseller/prices vypíše vaše tarify. Objednávka bez něj bude odmítnuta — viz varování níže. | | Fakturační interval | ne | monthly (měsíčně, výchozí) nebo annual (ročně) — interval, ve kterém je účtována vaše velkoobchodní řada pro tohoto klienta. Částka, kterou účtujete vlastnímu klientovi, se nastavuje u produktu ve WHMCS a zůstává nedotčena. |

⛔⛔ Kód tarifu je povinný a objednávka bez něj je úmyslně odmítnuta. Do 1. 9. 2026 bylo toto pole pouze dekorativní a nikdo jej nečetl, takže modul objednal hosting, který neobsahoval vůbec žádný tarif — a všechny důsledky toho byly tiché. Váš velkoobchodní výpis se vytváří na základě živých předplatných vašich klientů, takže pro tuto službu neexistoval žádný řádek a za celou dobu jejího provozu vám nebylo nic vyfakturováno; váš klient nezdědil žádné kvóty, takže na jeho web nebyla aplikována žádná disková ani souborová kvóta; a změna balíčku neměla co měnit, takže vámi prodaný upgrade nebylo možné provést. Web se přitom řádně zřídil a fungoval bez problémů.

Modul nyní místo toho objednávku odmítne, protože neexistuje žádný bezpečný tarif, který by mohl odhadnout: odhad by zřídil hosting na tarifu, který jste si nevybrali a možná ani neocenili, a na rozdíl od odmítnutí, které si přečtěte okamžitě, by se tato skutečnost projevila až při doručení vyúčtování, pokud vůbec.

Nastavte Automatické nastavení podle svých preferencí — modul je idempotentní vůči ID služby ve WHMCS, takže opakované zřízení vrátí stejný web namísto účtování druhého.

Co dělá jednotlivé akce ve WHMCS

| Akce WHMCS | Co se stane na naší straně | | --------------------------- | ---------------------------------------------------------------------------------------- | | Vytvořit (Create) | Vytvoří účet Zinn® klienta (nebo použije již existující) a zřídí jeho web. | | Pozastavit (Suspend) | Umístí web do stavu pozastavení kvůli neplacení. Obsah je zachován, nic se nesmaže. | | Zrušit pozastavení (Unsuspend) | Uvolní vaše pozastavení. | | Ukončit (Terminate) | Naplánuje smazání webu s odkladnou lhůtou. Datum se zobrazí v klientské zóně. | | Aktualizace využití | Aktualizuje využití disku a šířky pásma u každé služby, jednou denně. | | Přihlásit se do panelu hostingu | Otevře jednorázový přihlašovací odkaz přímo do panelu vašeho klienta. | | Změnit balíček (Change Package) | Provede upgrade nebo downgrade služby. Změní balíček a případně i verzi PHP, pokud ji nový produkt uvádí. | | Změnit heslo | Nastaví heslo správce WordPress. Toto pole se nezobrazuje u zásobníků, které takový účet nemají. | | Obnovit (Renew) | Potvrdí, že služba stále existuje. Hosting Zinn® je nepřetržitý, takže neexistuje žádné vzdálené období k prodloužení. | | Synchronizovat využití / Vymazat mezipaměť / Vytvořit zálohu | Tlačítka na stránce administrace služby. Váš klient má k dispozici Vymazání mezipaměti a Vytvoření zálohy ve své klientské zóně. | | Karta Služba | Stav, tarif, disk, šířka pásma, případné naplánované smazání a kdo pozastavení udělil. | | Import | ListAccounts načte každou stránku, takže import se nemůže tiše zastavit u té první. |

Upgrades: kdo komu účtuje

Zinn® vašemu klientovi nikdy nefakturuje, a to ani při objednávce, ani při upgradu. Vy jim fakturujete přes WHMCS; my fakturujeme vám na vašem velkoobchodním výpisu. Změna balíčku tedy přesune nároky vašeho klienta a řádek na vašem příštím výpisu a nedotkne se žádné karty — WHMCS již peníze od vašeho klienta přijalo a vypočítalo vlastní poměrnou část.

Druhá služba klienta. Ve stejném tarifu jde o další web v rámci povoleného počtu webů daného tarifu a nic dalšího se neposkytuje. V jiném tarifu je odmítnuta: nahrazení aktivního tarifu by zanechalo jednu ze dvou služeb bez vyúčtování. Buď prodávejte obě ve stejném tarifu, nebo klienta nastavte ve WHMCS jako samostatný záznam klienta.

Změna hesla existuje pouze pro WordPress. Hosting Zinn® nemá jediné „heslo služby“ — váš klient se do svého panelu dostane pomocí přihlašovacího tlačítka — a web typu php nebo static nemá žádný aplikační účet, který by bylo možné měnit. WHMCS toto pole raději zcela skrývá, než aby zobrazovalo něco, co nemůže fungovat.

Tři odpovědi, které nesmíte splácat do dvou

Zrušení pozastavení může skončit odmítnutím. To znamená, že web byl pozastaven naším týmem pro řešení zneužití (abuse), nikoli vámi, a žádný fakturační panel jej nesmí uvolnit. Zpráva to uvádí; ukažte ji svému správci namísto opakování pokusu.
Ukončení naplánuje smazání, neprovede jej. Datum se vrátí jako pending_deletion_at a zobrazí se v klientské zóně. Tvrdit zákazníkovi, že jeho data jsou již pryč, když tomu tak není, je horší než mu neříkat nic.
Disk a šířka pásma mohou být neznámé a neznámé neznamená nula. Pokud se nám nepodařilo provést odečet, modul ponechá hodnotu bez změny namísto zápisu 0 — v opačném případě by WHMCS ukazovalo vašemu zákazníkovi uklidňující prázdný panel využití pro web, ze kterého nemáme žádný odečet.

Řešení problémů

Test připojení proběhne úspěšně, ale první objednávka selže s chybou oprávnění. V klíči API chybí oprávnění org.create. Modul musí před vytvořením webu nejdříve otevřít účet klienta.

Objednávka selže s hlášením, že organizace nemá žádný hostingový tarif. Váš partnerský tarif již nemá volnou kapacitu pro weby nebo ještě žádný nevlastníte. Viz část Než začnete výše.

Objednávka selže s odkazem na zásobník (stack). Pole Zásobník (Stack) u produktu je prázdné nebo uvádí něco, co nevytváříme. Nastavte jej na wordpress, pokud neprodáváte něco jiného.

Zrušení služeb selhávají. Ujistěte se, že používáte modul ve verzi 1.0.0 nebo novější. Starší sestavení neodesílala potvrzení o smazání a každé ukončení bylo odmítnuto, což ponechalo službu spuštěnou a fakturovanou.

Odmítnutí, které uvádí konkrétní pole. Naše chybové zprávy uvádějí pole a důvod v závorkách za zprávou, např. (php_version: 7.2 is not offered on this product line). To je ta užitečná polovina — věta před ní je záměrně obecná.

Ověření stažení

Každý archiv je poskytován přes protokol TLS z našeho vlastního hostitele a nikdy není přesměrován na hostitele třetí strany. Jeho kontrolní součet SHA-256 je vytištěn vedle odkazů ke stažení na stránce ke stažení. Po stažení jej porovnejte:

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

Nepoužíváte WHMCS?

K dispozici je modul HostBill a jednosouborový klient v PHP pro cokoli jiného, obojí zdarma a na stejné stránce ke stažení. Každý koncový bod, který moduly používají, je uveden v dokumentaci API.