Vindeți găzduire Zinn® prin WHMCS

Modulul Zinn Digital® transformă butoanele WHMCS în acțiuni reale pe platforma noastră. O comandă pune în funcțiune găzduirea clientului dumneavoastră. Automatizarea pentru facturi scadente din WHMCS o suspendează. Marcarea facturii ca plătită o deblochează. Anularea programează ștergerea. Iar clientul dumneavoastră primește un buton Conectați-vă la panoul de găzduire în aria sa de clienți, care îl autentifică direct.

Este gratuit, licențiat sub GPL-2.0-or-later și nu are nicio cale privilegiată către platforma noastră: fiecare apel pe care îl efectuează este un punct final documentat pe care l-ați putea face chiar dumneavoastră cu propria cheie API.

Înainte de a începe

Aveți nevoie de două lucruri, iar al doilea îi pune în încurcătură pe mulți.

1. Un cont de reseller Zinn® cu un program activ. Înregistrați-vă pe

zinndigital.com și activați calitatea de reseller.

2. Un abonament de reseller cu alocare de site-uri. Site-urile comandate de clienții dumneavoastră se scad din contul dumneavoastră, așa că aveți nevoie de un abonament care să permită acest lucru.

⚠️ Testarea conexiunii nu poate spune dacă o comandă va reuși. Aceasta citește programul dumneavoastră și nu configurează nimic, așa că raportează un cont active sănătos care nu poate vinde încă nimic. Dacă prima dumneavoastră comandă eșuează cu mesajul "Această organizație nu are niciun plan de găzduire, deci nu poate găzdui încă un site", tocmai asta s-a întâmplat — cumpărați sau prelungiți-vă planul de reseller și plasați comanda din nou. Nu este nicio problemă cu modulul.

1. Creați cheia API

În tabloul de bord Zinn®, deschideți Chei API și creați una cu exact aceste unsprezece permisiuni:

| Permisiune | De ce este necesară | | -------------------- | ----------------------------------------------------------- | | org.create | Deschide contul Zinn® al clientului la prima sa comandă. | | org.read | Citește conturile clienților dumneavoastră. | | sites.create | Configurează site-ul. | | sites.view | Citește un serviciu și utilizarea acestuia. | | sites.delete | Termină serviciul. | | reseller.view | Listează ceea ce ați vândut și citește spațiul și lățimea de bandă. | | reseller.provision | Suspendă, deblochează, autentifică un client, îi setează planul și îi schimbă pachetul. | | billing.view | Citește costul unui upgrade înainte de a-l efectua. | | sites.manage | Golește memoria cache și efectuează o copie de rezervă din butoane. | | sites.panel_access | Schimbă parola administratorului WordPress. | | hosting.php.manage | Schimbă versiunea PHP la un upgrade sau downgrade. |

⛔ Nu acordați reseller.manage. O cheie introdusă într-un panou de facturare ar trebui să poată bloca un client pentru neplată și să îl autentifice. Nu ar trebui să poată citi și rescrie propriile credențiale ale gateway-ului de plată. reseller.provision există tocmai pentru a nu fi nevoit să acordați permisiunea extinsă. ⛔ org.create nu este opțională. Fără ea, modulul vă poate citi conturile, dar nu poate deschide unul nou, astfel încât Testarea conexiunii reușește, iar prima comandă returnează 403. ⛔⛔ Acordați acces pentru tot tabelul și rețineți că Testarea conexiunii nu vă poate spune dacă v-a lipsit ceva. Aceasta citește programul de reseller și nu configurează nimic, așa că va fi afișată cu verde pentru o cheie căreia îi lipsește oricare dintre aceste permisiuni. În schimb, veți primi o eroare 403 la singura operațiune acoperită de permisiunea lipsă, luni mai târziu, de la un client.

2. Instalați modulul

1. Descărcați modulul și dezarhivați-l.
2. Încărcați directorul zinn în instalarea dumneavoastră WHMCS, astfel încât fișierul modulului să

fie plasat la modules/servers/zinn/zinn.php.

⛔ Directorul trebuie să se numească zinn. WHMCS preia numele funcțiilor unui modul de configurare din numele directorului său, așa că redenumirea în zinn-whmcs sau zinndigital generează un modul pe care WHMCS îl listează, vă permite să îl selectați, dar pe care nu îl apelează niciodată — fără nicio eroare nicăieri. Arhiva zip se dezarhivează deja cu numele corect; pur și simplu nu o redenumiți.

3. Adăugați serverul

În WHMCS: Configurare → Setări de sistem → Servere → Adăugare server nou.

• Nume: oricare, de ex. Zinn Digital®
• Nume gazdă: api.zinndigital.com
• Tip: Zinn Digital®
• Parolă: cheia API de la pasul 1

⛔ Cheia se introduce în câmpul Parolă, pe care WHMCS îl stochează criptat. Nu o introduceți într-o opțiune de configurare a produsului — acestea sunt în text simplu în baza de date și vizibile pentru orice administrator, iar această credențială poate crea și distruge găzduirea clienților dumneavoastră.

Apăsați Testare conexiune. Aceasta face un apel real și raportează ce a transmis platforma noastră, în loc să verifice doar dacă câmpurile sunt completate.

4. Creați produsul

Configurare → Setări de sistem → Produse/Servicii, apoi setați Setări modul la serverul pe care tocmai l-ați adăugat. Câmpurile sunt:

| Câmp | Obligatoriu | Ce reprezintă | | ---------------- | ----------- | -------------------------------------------------------------------------- | | Linia de produse | da | Linia Zinn® pe care o vindeți — mainstream (WordPress administrat), footprint_free, wordpress, linux, cloud, agency, app_hosting, ai_hosting, lms_hosting, managed_database, vector_hosting, zinn_compute, fleet_linux, fleet_enterprise, mail sau reseller. | | Stivă | da | Ce anume este creat: wordpress (implicit), woocommerce, php, static, node, one_click, headless_cms, nextcloud sau owncloud. | | Aplicație | nu | Numai pentru stivele one_click și headless_cms — ce aplicație să fie instalată. Specificarea uneia pe orice altă stivă este refuzată, deoarece acea stivă decide deja ce se instalează. | | Versiune PHP | nu | de ex. 8.3. Lăsați gol pentru valoarea implicită a liniei. O versiune pe care linia nu o oferă este refuzată împreună cu lista celor disponibile. | | Cod plan | da | Planul Zinn® pe care îl vinde acest produs. GET /v1/reseller/prices listează prețurile dumneavoastră. O comandă fără acest cod este refuzată — consultați avertismentul de mai jos. | | Interval de facturare | nu | monthly (implicit) sau annual — intervalul la care este facturată linia dumneavoastră angro pentru acest client. Prețul pe care îl percepeți propriului client este setat în produsul WHMCS și nu este afectat. |

⛔⛔ Codul planului este obligatoriu, iar o comandă fără acesta este refuzată în mod intenționat. Până la 01.09.2026, acest câmp a fost pur decorativ și nu a fost citit de nimeni, așa că modulul a comandat o găzduire care nu avea niciun plan — și fiecare consecință a acest lucru a trecut neobservată. Situl dumneavoastră angro este generat pe baza abonamentelor active ale clienților dumneavoastră, așa că nu exista nicio linie pentru acest serviciu și nu vi s-a facturat nimic pe parcursul funcționării sale; clientul dumneavoastră nu a moștenit nicio alocare, așa că nu s-a aplicat nicio cotă de disc sau fișiere site-ului său; și Modificarea pachetului nu a avut ce să modifice, așa că un upgrade pe care l-ați vândut nu a putut fi efectuat. Site-ul a fost pus în funcțiune și a funcționat perfect în tot acest timp.

În prezent, modulul refuză comanda în schimb, deoarece nu există un plan sigur pe care să îl ghicească: o estimare ar configura o găzduire pe un plan pe care nu l-ați ales și pe care s-ar putea să nu îl fi inclus în oferte și — spre deosebire de un refuz, pe care îl citiți imediat — o astfel de problemă ar ieși la iveală abia când sosise o factură, dacă chiar și atunci.

Setați Configurare automată după preferințe — modulul este idempotent în raport cu ID-ul serviciului WHMCS, astfel încât o configurare reîncercată va returna același site în loc să vă factureze pentru un al doilea.

Ce face fiecare acțiune WHMCS

| Acțiune WHMCS | Ce se întâmplă de partea noastră | | --------------------------- | ---------------------------------------------------------------------------------------- | | Creare | Creează contul Zinn® al clientului (sau îl refolosește pe cel existent) și configurează site-ul acestuia. | | Suspendare | Plasează site-ul în așteptare din cauza neplății. Conținutul este păstrat; nu se șterge nimic. | | Anulare suspendare | Ridică suspendarea aplicată de dumneavoastră. | | Terminare | Programează ștergerea site-ului, cu o perioadă de grație. Data este afișată în aria de clienți. | | Actualizare utilizare | Reîmprospătează spațiul pe disc și lățimea de bandă pentru fiecare serviciu, o dată pe zi. | | Conectați-vă la panoul de găzduire | Deschide un link de autentificare de unică folosință direct în panoul clientului dumneavoastră. | | Modificare pachet | Efectuează upgrade-ul sau downgrade-ul serviciului. Mută pachetul și versiunea PHP dacă noul produs specifică una. | | Modificare parolă | Setează parola administratorului WordPress. Câmpul nu apare pe stivele care nu au un astfel de cont. | | Reînnoire | Confirmă că serviciul încă există. Găzduirea Zinn® este continuă, așa că nu există nicio perioadă de la distanță de prelungit. | | Sincronizare utilizare / Golire cache / Creare copie de rezervă | Butoane pe pagina de administrare a serviciului. Clientul dumneavoastră are acces la Golire cache și Creare copie de rezervă în aria sa de clienți. | | Tab-ul Serviciu | Stare, plan, disc, lățime de bandă, orice ștergere programată și cine a aplicat o suspendare. | | Import | ListAccounts citește fiecare pagină, astfel încât un import nu se poate opri silențios la prima dintre ele. |

Upgrade-uri: cine pe cine facturează

Clientul dumneavoastră nu este niciodată facturat de Zinn®, nici la o comandă, nici la un upgrade. Îl facturați prin intermediul WHMCS; noi vă facturăm pe dumneavoastră, pe extrasul de cont angro. Prin urmare, o modificare de pachet mută drepturile clientului dumneavoastră și linia din următorul extras de cont și nu atinge niciun card — WHMCS a încasat deja banii de la clientul dumneavoastră și și-a calculat propria proratizare.

Un al doilea serviciu al unui client. Pe același plan, acesta este un alt site inclus în limita de site-uri a acelui plan și nu se acordă nimic suplimentar. Pe un plan diferit, este refuzat: înlocuirea planului activ ar lăsa unul dintre cele două servicii nefacturat. Fie vindeți-le pe amândouă pe același plan, fie configurați clientul ca o înregistrare de client separată în WHMCS.

Modificarea parolei există doar pentru WordPress. Găzduirea Zinn® nu are o singură „parolă de serviciu” — clientul dumneavoastră accesează panoul cu butonul de autentificare —, iar un site php sau static nu are un cont de aplicație a cărui parolă să poată fi schimbată. WHMCS ascunde complet cămpul în loc să afișeze unul care nu poate funcționa.

Trei răspunsuri pe care nu trebuie să le reduceți la două

• Anularea suspendării poate returna un refuz. Aceasta înseamnă că site-ul a fost suspendat de echipa

noastră de abuzuri, nu de dumneavoastră, și niciun panou de facturare nu îl poate debloca. Mesajul precizează acest lucru; arătați-l administratorului dumneavoastră în loc să reîncercați.

• Terminarea programează o ștergere, nu o execută efectiv. Data este returnată ca

pending_deletion_at, iar aria de clienți o afișează. Să-i spui unui client că datele sale au fost deja șterse când ele nu sunt este mai rău decât să nu i se spună nimic.

• Spațiul pe disc și lățimea de bandă pot fi necunoscute, iar starea de necunoscut nu înseamnă zero.

Atunci când nu am putut face o citire, modulul lasă valoarea neschimbată în loc să scrie 0 — altfel, WHMCS i-ar arăta clientului o bară de utilizare goală liniștitoare pentru un site despre care nu avem nicio citire.

Depanare

Testarea conexiunii reușește, iar prima comandă eșuează cu o eroare de permisiuni. Cheia API nu are permisiunea org.create. Modulul trebuie să deschidă contul clientului înainte de a-i putea crea site-ul.

O comandă eșuează menționând că organizația nu are un plan de găzduire. Planul dumneavoastră de reseller nu mai are locuri disponibile pentru site-uri sau nu dețineți încă unul. Consultați secțiunea Înainte de a începe de mai sus.

O comandă eșuează menționând o stivă. Câmpul Stivă al produsului este gol sau menționează ceva ce nu construim. Setați-l la wordpress decât dacă vindeți altceva.

Anulările eșuează. Asigurați-vă că folosiți versiunea 1.0.0 sau o versiune ulterioară a modulului. Versiunile anterioare nu trimiteau nicio confirmare de ștergere și fiecare terminare era refuzată, ceea ce lăsa serviciul în funcțiune și în curs de facturare.

Un refuz care menționează un câmp

Erorile noastre de validare menționează câmpul și motivul între paranteze după mesaj, de ex. (php_version: 7.2 is not offered on din această linie de produse). Aceasta este jumătatea acționabilă — propoziția din fața ei este în mod deliberat generică.

Verificați descărcarea

Fiecare arhivă este livrată prin TLS de pe propriul nostru nume de gazdă și nu este niciodată redirecționată către o găzduire terță parte. Suma de control SHA-256 a acesteia este afișată lângă linkul de descărcare de pe pagina de descărcări. Comparați-o după descărcare:

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

Nu folosiți WHMCS?

Există un modul HostBill și un client PHP dintr-un singur fișier pentru orice altceva, ambele gratuite și ambele disponibile pe aceeași pagină de descărcări. Fiecare punct final utilizat de module se află în referința API.