Prodajte Zinn® hosting putem WHMCS-a

Modul Zinn Digital® pretvara gumbe unutar sustava WHMCS u stvarne radnje na našoj platformi. Narudžba priprema hosting Vašeg klijenta. Automatizacija neplaćenih računa unutar sustava WHMCS ga suspendira. Označavanje računa plaćenim ga reaktivira. Otkazivanje zakazuje brisanje. A Vaš klijent u svom korisničkom dijelu dobiva gumb Log in to hosting panel koji ga izravno prijavljuje.

Besplatan je, licenciran pod GPL-2.0-or-later i nema povlašteni pristup našoj platformi: svaki poziv koji izvršava dokumentirana je krajnja točka koju možete i sami pozvati vlastitim API ključem.

Prije nego što počnete

Potrebne su Vam dvije stvari, a druga često promakne korisnicima.

1. Zinn® preprodavački račun s aktivnim programom. Registrirajte se na

zinndigital.com i uključite preprodaju.

2. Preprodavački paket s raspoloživim brojem stranica. Stranice koje Vaši klijenti naruče ubrajaju se u Vaš

paket, stoga Vam je potreban paket u kojem imate slobodnog mjesta.

⚠️ Test Connection ne može Vam reći hoće li narudžba uspjeti. On samo očitava Vaš program i ništa ne priprema, stoga prijavljuje ispravan active račun koji još uvijek ne može ništa prodavati. Ako Vaša prva narudžba ne uspije uz poruku "This organization has no hosting plan, so it cannot host a site yet", upravo se to dogodilo — kupite ili proširite svoj preprodavački paket i ponovno pošaljite narudžbu. S modulom je sve u redu.

1. Izradite API ključ

Na svojoj Zinn® upravljačkoj ploči otvorite API keys i izradite ključ s točno ovih jedanaest dozvola:

⛔ Nemojte dodijeliti reseller.manage. Ključ zalijepljen u naplatnu ploču trebao bi moći zadržati klijenta zbog neplaćanja i prijaviti ga. Ne bi trebao moći čitati i mijenjati vjerodajnice Vašeg vlastitog pristupnika za plaćanje. Dozvola reseller.provision postoji kako ne biste morali dodijeliti ovu veću. ⛔ org.create nije izborna. Bez nje modul može čitati Vaše račune, ali ne može otvoriti novi, pa Test Connection prolazi, a prva narudžba vraća 403. ⛔⛔ Dodijelite cijelu tablicu i imajte na umu da Vam Test Connection ne može reći ako to niste učinili. On očitava Vaš preprodavački program i ništa ne priprema, stoga je zelen čak i za ključ kojemu nedostaje bilo koja od ovih stavki. Umjesto toga, mjesecima kasnije, od kupca ćete dobiti pogrešku 403 na onoj operaciji koju pokriva dozvola koja nedostaje.

2. Instalirajte modul

1. Preuzmite modul i raspakirajte ga.
2. Prenesite direktorij zinn u svoju instalaciju sustava WHMCS tako da datoteka modula završi na

modules/servers/zinn/zinn.php.

⛔ Direktorij se mora zvati zinn. WHMCS nazive funkcija modula za pripremu izvodi iz naziva njegova direktorija, stoga preimenovanje u zinn-whmcs ili zinndigital stvara modul koji WHMCS prikazuje na popisu, dopušta Vam odabir, a zatim ga nikada ne poziva — bez ikakve pogreške. Zip se već raspakirava pod ispravnim nazivom; samo ga nemojte preimenovati.

3. Dodajte poslužitelj

U sustavu WHMCS: Configuration → System Settings → Servers → Add New Server.

• Name: bilo što, npr. Zinn Digital®
• Hostname: api.zinndigital.com
• Type: Zinn Digital®
• Password: Vaš API ključ iz 1. koraka

⛔ Ključ se unosi u polje Password, koje WHMCS pohranjuje šifrirano. Nemojte ga stavljati u konfiguracijsku opciju proizvoda — one se u bazi podataka nalaze kao čisti tekst i vidljive su svakom administratoru, a ova vjerodajnica može stvarati i brisati hosting Vaših klijenata.

Pritisnite Test Connection. On izvršava stvarni poziv i prijavljuje odgovor naše platforme, umjesto da samo provjeri jesu li polja popunjena.

4. Izradite proizvod

Configuration → System Settings → Products/Services, zatim postavite Module Settings na poslužitelj koji ste upravo dodali. Polja su:

⛔⛔ Plan code je obavezan, a narudžba bez njega namjerno se odbija. Do

1. 9. 2026. polje je bilo dekorativno i ništa ga nije čitalo, pa je modul naručivao hosting koji

nije imao nikakav paket — a sve posljedice toga bile su neprimjetne. Vaš veleprodajni obračun sastavlja se iz aktivnih pretplata Vaših klijenata, pa nije bilo stavke za tu uslugu i nije Vam naplaćeno ništa za cijelo vrijeme njezina rada; Vaš klijent nije naslijedio nikakva prava, pa na njegovu stranicu nije primijenjena kvota diska ni datoteka; i Change Package nije imao što promijeniti, pa se nadogradnja koju ste prodali nije mogla izvršiti. Stranica se cijelo vrijeme bez problema pripremala i posluživala.

Modul sada umjesto toga odbija narudžbu jer ne postoji siguran paket koji bi mogao pretpostaviti: pretpostavka bi pripremila hosting na paketu koji niste odabrali i za koji možda niste odredili cijenu, te bi se — za razliku od odbijanja, koje odmah vidite — pojavila tek kada stigne obračun, ako i tada.

Postavite Auto Setup na opciju koja Vam više odgovara — modul je idempotentan prema ID-ju WHMCS usluge, pa ponovljeni pokušaj pripreme vraća istu stranicu umjesto da Vam naplati drugu.

Što radi pojedina radnja u sustavu WHMCS

Nadogradnje: tko kome naplaćuje

Zinn® Vašem klijentu nikada ne izdaje račun, ni pri narudžbi ni pri nadogradnji. Vi im naplaćujete putem sustava WHMCS; mi naplaćujemo Vama, na Vašem veleprodajnom obračunu. Dakle, Change Package mijenja prava Vašeg klijenta i stavku na Vašem sljedećem obračunu, a ne tereti karticu — WHMCS je već naplatio novac od Vašeg klijenta i izračunao vlastiti razmjerni dio (proraciju).

Druga usluga klijenta. Na istom paketu to je još jedna stranica unutar dopuštenog broja stranica tog paketa i ništa se dodatno ne odobrava. Na drugom paketu se odbija: zamjena aktivnog paketa ostavila bi jednu od dviju usluga neneplaćenom. Ili prodajte obje na istom paketu ili klijenta postavite kao zaseban zapis klijenta u sustavu WHMCS.

Change Password postoji samo za WordPress. Zinn® hosting nema jedinstvenu "lozinku usluge" — Vaš klijent pristupa svojoj ploči putem gumba za prijavu — a php ili static stranica nema korisnički račun aplikacije koji bi se mijenjao. WHMCS u potpunosti skriva to polje umjesto da prikazuje ono koje ne može raditi.

Tri odgovora koja ne smijete svesti na dva

• Unsuspend može odgovoriti odbijanjem. To znači da je stranicu suspendirao naš tim za zloupotrebu,

a ne Vi, i nijedna naplatna ploča ne smije je reaktivirati. Poruka to navodi; pokažite je svom administratoru umjesto ponovnog pokušaja.

• Terminate zakazuje brisanje, ne izvršava ga odmah. Datum se vraća kao

pending_deletion_at i korisnički dio ga prikazuje. Reći kupcu da su njegovi podaci već nestali kada to nije slučaj gore je nego ne reći mu ništa.

• Disk i promet mogu biti nepoznati, a nepoznato nije nula. Kada nismo mogli očitati

podatke, modul ostavlja vrijednost nepromijenjenom umjesto upisivanja 0 — inače bi WHMCS Vašem kupcu prikazao umirujući prazan grafikon potrošnje za stranicu za koju nemamo očitanje.

Rješavanje problema

Test Connection prolazi, a prva narudžba ne uspijeva uz pogrešku o dozvolama. API ključu nedostaje org.create. Modul mora otvoriti račun klijenta prije nego što može izraditi njegovu stranicu.

Narudžba ne uspijeva uz poruku da organizacija nema hosting paket. Vaš preprodavački paket nema više raspoloživih stranica ili ga još nemate. Pogledajte odlomak Prije nego što počnete iznad.

Narudžba ne uspijeva uz spominjanje stoga. Polje Stack na proizvodu je prazno ili navodi nešto što mi ne izrađujemo. Postavite ga na wordpress, osim ako ne prodajete nešto drugo.

Otkazivanja ne uspijevaju. Provjerite koristite li verziju modula 1.0.0 ili noviju. Ranije verzije nisu slale potvrdu o brisanju i svako gašenje (terminacija) bilo je odbijeno, zbog čega je usluga ostajala aktivna i naplaćivala se.

Odbijanje koje navodi polje. Naše pogreške pri provjeri valjanosti navode polje i razlog u zagradama nakon poruke, npr. (php_version: 7.2 is not offered on this product line). To je korisni dio na temelju kojeg možete djelovati — rečenica ispred njega namjerno je općenita.

Provjerite svoje preuzimanje

Svaka se arhiva poslužuje putem TLS-a s našeg vlastitog naziva poslužitelja i nikada se ne preusmjerava na poslužitelje trećih strana. Njezin SHA-256 kontrolni zbroj otisnut je pored poveznice za preuzimanje na stranici za preuzimanja. Usporedite ga nakon preuzimanja:

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

Ne koristite WHMCS?

Dostupan je HostBill modul i jednodatotečni PHP klijent za sve ostalo, oboje besplatno i oboje na istoj stranici za preuzimanja. Svaka krajnja točka koju moduli koriste nalazi se u API referenci.