Prodajte Zinn® hosting putem WHMCS-a

Modul Zinn Digital® pretvara vlastite gumbe WHMCS-a u stvarne radnje na našoj platformi. Narudžba osigurava hosting za vašeg klijenta. Automatizacija dospjelih računa WHMCS-a ga suspendira. Označavanje računa plaćenim ga oslobađa. Otkazivanje zakazuje brisanje. A vaš klijent dobiva gumb Prijava u upravljačku ploču za hosting u svom korisničkom području koji ga prijavljuje izravno.

Besplatan je, licenciran pod uvjetima GPL-2.0-or-later i nema povlašteni put do naše platforme: svaki poziv koji uputi predstavlja dokumentiranu krajnju točku koju biste sami mogli izvesti s vlastitim API ključem.

Prije nego što počnete

Potrebne su vam dvije stvari, pri čemu druga često zbunjuje ljude.

1. Zinn® resellerski račun s aktivnim programom. Prijavite se na zinndigital.com i uključite reselling.
2. Resellerski paket s kvotom za web-mjesta. Web-mjesta koja vaši klijenti naruče troše kvotu vašeg paketa, stoga vam je potreban paket s raspoloživim prostorom.

⚠️ Testiranje veze ne može vam reći hoće li narudžba uspjeti. Ono čita vaš program i ne osigurava ništa, pa prijavljuje zdrav active račun koji još uvijek ne može ništa prodati. Ako vaša prva narudžba ne uspije uz poruku "This organization has no hosting plan, so it cannot host a site yet", dogodilo se upravo to — kupite ili produljite svoj resellerski 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:

| Dozvola | Zašto je potrebna | | -------------------- | ----------------------------------------------------------- | | org.create | Otvaranje Zinn® računa vašeg klijenta pri njihovoj prvoj narudžbi. | | org.read | Čitanje računa vaših klijenata. | | sites.create | Osiguravanje web-mjesta. | | sites.view | Čitanje usluge i njezine upotrebe. | | sites.delete | Prekid usluge. | | reseller.view | Popis prodanog te čitanje zauzeća diska i propusnosti. | | reseller.provision | Suspendiranje, oslobađanje, prijava klijenta, postavljanje i izmjena njihovog paketa. | | billing.view | Čitanje cijene nadogradnje prije njezina izvršenja. | | sites.manage | Čišćenje predmemorije i izrada sigurnosne kopije putem gumba. | | sites.panel_access | Izmjena lozinke administratora za WordPress. | | hosting.php.manage | Promjena verzije PHP-a prilikom nadogradnje ili smanjenja verzije. |

⛔ Nemojte dodijeliti dozvolu reseller.manage. Ključ zalijepljen u ploču za naplatu trebao bi moći blokirati klijenta zbog neplaćanja i prijaviti ga. Ne bi trebao moći čitati i prepisivati vaše vlastite vjerodajnice pristupnika za plaćanje. Dozvola reseller.provision postoji kako ne biste morali dodjeljivati širu dozvolu. ⛔ Dozvola org.create nije opcionalna. Bez nje modul može čitati vaše račune, ali ih ne može otvoriti, stoga testiranje veze prolazi, a prva narudžba vraća odgovor 403. ⛔⛔ Dodijelite cijelu tablicu i imajte na umu da testiranje veze ne može otkriti ako to niste učinili. Ono čita vaš resellerski program i ne osigurava ništa, pa će biti zeleno i za ključ kojem nedostaje bilo koja od ovih dozvola. Umjesto toga, mjesecima kasnije od klijenta ćete dobiti pogrešku 403 za onu operaciju koju obuhvaća nedostajuća dozvola.

2. Instalirajte modul

1. Preuzmite modul i raspakirajte ga.
2. Učitajte direktorij zinn u svoju WHMCS instalaciju tako da datoteka modula bude smještena na modules/servers/zinn/zinn.php.

⛔ Direktorij se mora zvati zinn. WHMCS izvodi nazive funkcija modula za pružanje usluga iz naziva njegova direktorija, stoga preimenovanje u zinn-whmcs ili zinndigital stvara modul koji WHMCS prikazuje, omogućuje vam odabir, ali ga nikada ne poziva — bez ikakve poruke o pogrešci. Arhiva zip već se raspakira u ispravan naziv; samo ga nemojte preimenovati.

3. Dodajte poslužitelj

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

• Naziv (Name): bilo što, npr. Zinn Digital®
• Naziv hosta (Hostname): api.zinndigital.com
• Vrsta (Type): Zinn Digital®
• Lozinka (Password): vaš API ključ iz 1. koraka

⛔ Ključ se unosi u polje Password, koje WHMCS pohranjuje u kriptiranom obliku. Nemojte ga unositi u opciju konfiguracije proizvoda — one su u običnom tekstu u bazi podataka i vidljive svakom administratoru, a ove vjerodajnice mogu stvarati i uništavati hosting vaših klijenata.

Pritisnite Test Connection. Time se pokreće stvarni poziv i izvještava o tome što je naša platforma odgovorila, umjesto provjere 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:

| Polje | Obavezno | Što je to | | ---------------- | -------- | -------------------------------------------------------------------------- | | Product line | da | Zinn® linija koju prodajete — mainstream (upravljani WordPress), footprint_free, wordpress, linux, cloud, agency, app_hosting, ai_hosting, lms_hosting, managed_database, vector_hosting, zinn_compute, fleet_linux, fleet_enterprise, mail ili reseller. | | Stack | da | Ono što se gradi: wordpress (zadano), woocommerce, php, static, node, one_click, headless_cms, nextcloud ili owncloud. | | Application | ne | Samo za one_click i headless_cms stogove — koja se aplikacija instalira. Navođenje aplikacije na bilo kojem drugom stogu bit će odbijeno jer taj stog već određuje što se instalira. | | PHP version | ne | npr. 8.3. Ostavite prazno za zadanu vrijednost linije. Verzija koju linija ne nudi bit će odbijena uz popis onih koje nudi. | | Plan code | da | Zinn® plan koji ovaj proizvod prodaje. GET /v1/reseller/prices navodi vaše. Narudžba bez njega bit će odbijena — pogledajte upozorenje u nastavku. | | Billing interval | ne | monthly (zadano) ili annual — interval po kojem se naplaćuje vaša veleprodajna linija za ovog klijenta. Ono što naplaćujete vlastitom klijentu postavlja se na WHMCS proizvodu i na to se ne utječe. |

⛔⛔ Kod plana je obavezan, a narudžba bez njega namjerno se odbija. Do 01.09.2026. ovo je polje imalo samo ukrasnu ulogu i ni jedan sustav ga nije čitao, zbog čega je modul naručivao hosting koji nije imao nikakav plan — a sve posljedice toga događale su se tiho. Vaš se veleprodajni obračun temelji na aktivnim pretplatama vaših klijenata, tako da nije postojala stavka za uslugu i nije vam se naplaćivalo ništa dok god je ona radila; vaš klijent nije naslijedio nikakve kvote, pa na njegovom web-mjestu nije bila primijenjena nikakva kvota diska ili datoteka; i značajka Change Package nije imala što promijeniti, pa se nadogradnja koju ste prodali nije mogla izvršiti. Web-mjesto se uredno osiguralo i u potpunosti funkcioniralo.

Modul sada umjesto toga odbija narudžbu jer ne postoji siguran plan koji bi mogao pogoditi: nagađanje bi osiguralo hosting na planu koji niste odabrali i čiju cijenu možda niste definirali, i — za razliku od odbijanja, koje vidite odmah — to bi izašlo na vidjelo tek po dolasku računa, ako uopće.

Postavite Auto Setup na ono što vam najviše odgovara — modul je idempotentan u odnosu na ID WHMCS usluge, pa ponovljeni pokušaj osiguravanja vraća isto web-mjesto umjesto da vam naplaćuje drugo.

Što radi pojedinačna WHMCS radnja

| WHMCS radnja | Što se događa na našoj strani | | --------------------------- | ---------------------------------------------------------------------------------------- | | Create | Izrađuje Zinn® račun klijenta (ili ponovno koristi postojeći) i osigurava njihovo web-mjesto. | | Suspend | Stavlja web-mjesto u stanje mirovanja zbog neplaćanja. Sadržaj se zadržava; ništa se ne briše. | | Unsuspend | Uklanja vašu blokadu. | | Terminate | Zakazuje brisanje web-mjesta uz poček (grace period). Datum je vidljiv u korisničkom području. | | Usage update | Osvježava podatke o disku i propusnosti za svaku uslugu jednom dnevno. | | Log in to hosting panel | Otvara jednokratnu vezu za prijavu koja vodi izravno u ploču vašeg klijenta. | | Change Package | Nadograđuje ili smanjuje razinu usluge. Premješta paket i verziju PHP-a ako je novi proizvod navodi. | | Change Password | Postavlja lozinku administratora za WordPress. Okvir se ne prikazuje na stogovima koji nemaju takav račun. | | Renew | Potvrđuje da usluga još uvijek postoji. Zinn® hosting je kontinuiran, pa ne postoji udaljeni rok koji je potrebno produljiti. | | Sync Usage / Purge Cache / Take Backup | Gumbi na stranici administrativne usluge. Vaš klijent dobiva opcije Purge Cache i Take Backup u svom korisničkom području. | | Service tab | Status, plan, disk, propusnost, svako zakazano brisanje i podatak tko je postavio suspenziju. | | Import | ListAccounts čita svaku stranicu, tako da uvoz ne može tiho stati na prvoj. |

Nadogradnje: tko kome naplaćuje

Zinn® nikada ne ispostavlja račun vašem klijentu, ni za narudžbu ni za nadogradnju. Vi ih naplaćujete putem WHMCS-a; mi naplaćujemo vama, na vašem veleprodajnom obračunu. Stoga Change Package prenosi prava vašeg klijenta i stavku na vašem sljedećem računu, a da pritom uopće ne dira karticu — WHMCS je već naplatio klijentu i izračunao vlastiti razmjerni dio (proration).

Druga usluga klijenta. Na istom planu to je još jedno web-mjesto u okviru dopuštenog broja web-mjesta tog plana i ne odobravaju se nikakve dodatne pogodnosti. Na drugom planu narudžba se odbija: zamjena aktivnog plana ostavila bi jednu od dviju usluga bez naplate. Ili prodajte obje na istom planu, ili postavite klijenta kao zaseban zapis klijenta u WHMCS-u.

Change Password postoji samo za WordPress. Zinn® hosting nema jedinstvenu „lozinku usluge” — vaš klijent pristupa svojoj ploči pomoću gumba za prijavu — a php ili static web-mjesto nema račun aplikacije čiju bi lozinku trebalo mijenjati. WHMCS u potpunosti sakriva okvir umjesto da prikazuje onaj koji ne može raditi.

Tri odgovora koja se ne smiju spojiti u dva

• Unsuspend može vratiti odbijenicu kao odgovor. To znači da je web-mjesto suspendirao naš tim za zlouporabu, a ne vi, i nijedna ploča za naplatu ga ne može deblokirati. Poruka to i govori; pokažite je svom administratoru umjesto da ponavljate pokušaj.
• Terminate zakazuje brisanje, ali ga ne izvršava odmah. Datum se vraća kao pending_deletion_at i prikazuje se u korisničkom području. Reći klijentu da su njegovi podaci već nestali kada zapravo nisu gora je opcija nego mu ne reći ništa.
• Disk i propusnost mogu biti nepoznati, a nepoznato nije nula. Kada nismo mogli izvršiti očitavanje, modul ostavlja vrijednost neizmijenjenom umjesto da upiše 0 — u suprotnom bi WHMCS vašem klijentu prikazao ohrabrujuću praznu traku korištenja za web-mjesto s kojeg nemamo očitavanje.

Rješavanje problema

Testiranje veze prolazi, a prva narudžba ne uspijeva zbog pogreške u dopuštenjima. API ključu nedostaje org.create. Modul mora otvoriti račun klijenta prije nego što može izraditi njihovo web-mjesto.

Narudžba ne uspijeva uz poruku da organizacija nema plan hostinga. Vaš resellerski paket više nema slobodnog prostora za web-mjesta ili ga još uvijek nemate. Pogledajte odjeljak Prije nego što počnete u nastavku.

Narudžba ne uspijeva uz spominjanje stoga. Polje Stack na proizvodu je prazno ili navodi nešto što mi ne gradimo. 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 izvedbe nisu slale potvrdu brisanja i svaki je prekid bio odbijen, što je ostavilo uslugu aktivnom i s obračunom troškova.

Odbijenica koja navodi polje. Naše pogreške u validaciji navode polje i razlog u uglatim zagradama nakon poruke, npr. (php_version: 7.2 is not offered on this product line). To je korisna polovica — rečenica ispred nje namjerno je općenita.

Provjerite svoje preuzimanje

Svaka se arhiva poslužuje putem TLS-a s našeg vlastitog naziva hosta i nikada se ne preusmjerava na poslužitelj treće strane. Njezin SHA-256 kontrolni zbroj ispisan je pored poveznice za preuzimanje na stranici za preuzimanje. 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?

Postoji modul za HostBill i datoteka PHP klijenta za bilo što drugo, oba besplatna i dostupna na istoj stranici za preuzimanje. Svaka krajnja točka koju moduli koriste nalazi se u API referenci.