База знања

Продајте Zinn® хостинг из WHMCS-а

Инсталирајте бесплатни модул за провизионисање Zinn Digital® у WHMCS: API кључ и седам дозвола које су му потребне, где директоријум модула мора да се налази и зашто је његово име важно, поља производа и шта свако дугме у WHMCS заправо ради.

Zinn®, наш викинг, чита своју контролну листу поред индекса чланака са једним отвореним.

Zinn Digital® модул претвара сопствене WHMCS дугмиће у стварне радње на нашој платформи. Поруџбина омогућава хостинг Вашег клијента. WHMCS аутоматизација за неплаћене рачуне га суспендује. Означавање рачуна као плаћеног га поново активира. Отказивање заказује брисање. А Ваш клијент у својој корисничкој зони добија дугме Пријавите се на контролну таблу хостинга које га директно пријављује.

Бесплатан је, лиценциран под GPL-2.0-or-later и нема повлашћен приступ нашој платформи: сваки позив који упућује јесте документована крајња тачка коју бисте могли сами позвати сопственим API кључем.

Пре него што почнете

Потребне су Вам две ствари, а друга често изненади кориснике.

  1. Zinn® налог за препродавце са активним програмом. Региструјте се на zinndigital.com и укључите препродају.
  2. План за препродавце са дозвољеним бројем сајтова. Сајтови које Ваши клијенти поруче урачунавају се у Ваш план, па Вам је потребан онај са слободним капацитетом.

⚠️ Тестирање везе не може Вам рећи да ли ће поруџбина успети. Оно очитава Ваш програм и не покреће ништа, па пријављује исправан active налог који још увек не може ништа да продаје. Ако Ваша прва поруџбина не успе уз поруку „Ова организација нема хостинг план, тако да још увек не може да хостује сајт“, управо се то догодило — купите или проширите свој план за препродавце и поново пошаљите поруџбину. Са модулом је све у реду.

1. Креирајте API кључ

На својој Zinn® контролној табли отворите API кључеви и креирајте један са тачно ових једанаест дозвола:

ДозволаЗашто је потребна
org.createОтворите Zinn® налог вашег клијента приликом њихове прве поруџбине.
org.readПрегледајте налоге својих клијената.
sites.createПрипремите сајт.
sites.viewПрегледајте услугу и њену потрошњу.
sites.deleteОбуставите.
reseller.viewИзлистајте оно што сте продали и прегледајте простор на диску и проток.
reseller.provisionСуспендујте, одблокирајте, пријавите клијента, подесите њихов тарифни пакет и промените њихов пакет.
billing.viewПогледајте колико би надоградња коштала пре него што је извршите.
sites.manageОчистите кеш и направите резервну копију помоћу дугмади.
sites.panel_accessПромените лозинку WordPress администратора.
hosting.php.manageПромените верзију PHP-а при надоградњи или преласку на нижи тарифни пакет.

⛔ Немојте доделити reseller.manage. Кључ налепљен у контролну таблу за наплату треба да има могућност да суспендује клијента због неплаћања и да га пријави. Не би требало да може да чита и мења ваше сопствене акредитиве за систем плаћања. reseller.provision постоји да не бисте морали да доделите ову већу дозволу. ⛔ org.create није опционо. Без тога модул може да чита ваше налоге али не може да отвори нови, па провера Test Connection пролази, а прва поруџбина враћа одговор 403. ⛔⛔ Доделите целу табелу и имајте на уму да вам Test Connection не може рећи ако то нисте учинили. Она чита ваш програм препродавца и ништа не припрема, па показује зелено за кључ коме недостаје било шта од овога. Уместо тога, месецима касније од корисника добијате грешку 403 при оној операцији коју недостајућа дозвола покрива.

2. Инсталирајте модул

  1. Преузмите модул и распакујте га.
  2. Отпремите директоријум zinn у своју WHMCS инсталацију тако да датотека модула буде смештена на modules/servers/zinn/zinn.php.

⛔ Директоријум се мора звати zinn. WHMCS изводи називе функција модула за обезбеђивање ресурса из назива његовог директоријума, па преименовање у zinn-whmcs или zinndigital ствара модул који WHMCS приказује на листи, дозвољава вам да га изаберете, а затим га никада не позива — без икакве грешке било где. Zip архива се већ распакује са исправним називом; само је немојте преименовати.

3. Додајте сервер

У WHMCS-у: Конфигурација → Подешавања система → Сервери → Додај нови сервер.

  • Назив: било шта, нпр. Zinn Digital®
  • Име хоста: api.zinndigital.com
  • Врста: Zinn Digital®
  • Лозинка: ваш API кључ из корака 1

⛔ Кључ се уноси у поље Лозинка, које WHMCS чува шифровано. Немојте га стављати у опцију за конфигурацију производа — оне су у бази података у обичном тексту и видљиве су сваком администратору, а ови акредитиви могу да креирају и униште хостинг ваших клијената.

Притисните Тестирај везу. Ово шаље прави позив и обавештава о томе шта је наша платформа одговорила, уместо да само проверава да ли су поља попуњена.

4. Креирајте производ

Конфигурација → Системска подешавања → Производи/Услуге, а затим подесите Подешавања модула на сервер који сте управо додали. Поља су:

ПољеОбавезноШта представља
Линија производадаZinn® линија коју продајете — mainstream (управљани WordPress), footprint_free, wordpress, linux, cloud, agency, app_hosting, ai_hosting, lms_hosting, managed_database, vector_hosting, zinn_compute, mail или reseller.
СтекдаШта се гради: wordpress (подразумевано), woocommerce, php, static, node, one_click, headless_cms, nextcloud или owncloud.
АпликацијанеСамо за стекове one_click и headless_cms — коју апликацију инсталирати. Навођење на било ком другом стеку биће одбијено, јер тај стек већ одређује шта се инсталира.
PHP верзијаненпр. 8.3. Оставите празно за подразумевану верзију дате линије. Верзија коју линија не нуди биће одбијена уз листу оних које нуди.
Шифра планадаZinn® план који овај производ продаје. GET /v1/reseller/prices наводи ваше. Поруџбина без ње биће одбијена — погледајте упозорење испод.
Интервал наплатенеmonthly (подразумевано) или annual — интервал према ком се издаје ваша велепродајна линија за овог клијента. Оно што наплаћујете сопственом клијенту подешава се на WHMCS производу и остаје непромењено.

⛔⛔ Код плана је обавезан, а поруџбина без њега се намерно одбија. До 2026-09-01 ово поље је било само декоративно и ништа га није читало, па је модул наручивао хостинг који није имао никакав план — а свака последица тога била је неприметна. Ваш велепродајни обрачун се формира на основу активних претплата ваших клијената, тако да није било ставке за ову услугу и ништа вам није фактурисано све време док је била активна; ваш клијент није наследио никакве ресурсе, па на његов сајт није примењена никаква квота за диск или датотеке; а опција Промени пакет није имала шта да промени, па надоградња коју сте продали није могла да се изврши. Сајт се све време беспрекорно покретао и радио.

Модул сада уместо тога одбија поруџбину, јер не постоји безбедан план који би могао да нагађа: нагађање би покренуло хостинг са планом који нисте изабрали и за који можда нисте одредили цену, и — за разлику од одбијања, које одмах видите — то би се приметило тек када стигне обрачун, ако и тада.

Подесите Аутоматско подешавање на шта год желите — модул је идемпотентан у односу на WHMCS id услуге, па поновљени покушај покретања враћа исти сајт уместо да вам наплати други.

Шта ради свака WHMCS акција

WHMCS радњаШта се дешава са наше стране
КреирајКреира клијентов Zinn® налог (или поново користи постојећи) и припрема њихов сајт.
СуспендујСтавља сајт на чекање због неплаћања. Садржај се задржава; ништа се не брише.
Укини суспензијуУклања вашу суспензију.
ОкончајЗаказује брисање сајта, уз грејс период. Датум се приказује у корисничком делу.
Ажурирање потрошњеОсвежава податке о диску и протоку за сваку услугу, једном дневно.
Пријавите се на контролни панел хостингаОтвара једнократни линк за пријаву директно у панел вашег клијента.
Промени пакетНадограђује или умањује ниво услуге. Премешта пакет, као и PHP верзију ако је нови производ наводи.
Промени лозинкуПоставља лозинку за WordPress администратора. Поље се не приказује на системима који немају такав налог.
ОбновиПотврђује да услуга и даље постоји. Zinn® хостинг је континуиран, тако да нема удаљеног рока за продужење.
Синхронизуј потрошњу / Очисти кеш / Направи резервну копијуДугмад на администраторској страници услуге. Ваш клијент добија Очисти кеш и Направи резервну копију у свом корисничком делу.
Картица УслугаСтатус, план, диск, проток, свако заказано брисање и податак о томе ко је поставио суспензију.
УвезиListAccounts чита сваку страницу, тако да увоз не може тихо стати на првој.

Надоградње: ко коме наплаћује

Вашем клијенту Zinn® никада не шаље фактуру, ни при наруџбини ни при надоградњи. Ви им наплаћујете путем WHMCS-а; ми наплаћујемо вама, на вашем велепродајном изводу. Дакле, Промени пакет преноси права вашег клијента и ставку на вашем следећем изводу, и не дира ниједну картицу — WHMCS је већ наплатио новац од вашег клијента и израчунао своју сразмерну наплату.

Друга услуга клијента. На истом тарифном пакету то је још један сајт у оквиру дозвољеног броја сајтова за тај пакет, и ништа додатно се не одобрава. На различитом пакету се одбија: замена активног пакета оставила би једну од две услуге ненаплаћеном. Или продајте обе на истом пакету, или подесите клијента као засебан запис клијента у WHMCS-у.

Промени лозинку постоји само за WordPress. Zinn® хостинг нема јединствену „лозинку за услугу“ — ваш клијент приступа свом панелу помоћу дугмета за пријављивање — а php или static сајт нема кориснички налог апликације који би се мењао. WHMCS у потпуности сакрива то поље уместо да приказује оно које не може да функционише.

Три одговора која не смете свести на два

  • Укидање суспензије може одговорити одбијањем. То значи да је сајт суспендовао наш тим за злоупотребе, а не ви, и ниједан панел за наплату га не може ослободити. Порука то и наводи; покажите је свом администратору уместо да покушавате поново.
  • Прекид услуге заказује брисање, али га не извршава. Датум се враћа као pending_deletion_at и кориснички панел га приказује. Рећи клијенту да су његови подаци већ обрисани када нису је горе него не рећи му ништа.
  • Диск и проток могу бити непознати, а непознато није нула. Када нисмо могли да очитамо вредности, модул оставља број онаквим какав јесте уместо да упише 0 — у супротном би WHMCS вашем клијенту приказао умирујућу празну траку потрошње за сајт за који немамо очитавање.

Решавање проблема

Тест повезивања успева, а прва поруџбина не успева уз грешку о дозволама. API кључу недостаје org.create. Модул мора да отвори налог клијента пре него што може да креира његов сајт.

Поруџбина не успева уз поруку да организација нема хостинг пакет. Ваш риселер пакет нема преосталих дозвољених сајтова, или га још увек немате. Погледајте одељак Пре него што почнете изнад.

Поруџбина не успева уз помињање стека. Поље Стек на производу је празно или наводи нешто што ми не правимо. Поставите га на wordpress осим ако не продајете нешто друго.

Отказивања не успевају. Уверите се да користите верзију модула 1.0.0 или новију. Раније верзије нису слале потврду о брисању и сваки прекид услуге је био одбијен, што је остављало услугу активном и наплаћиваном.

Одбијање које именује поље. Наше грешке при верификацији наводе поље и разлог у заградама након поруке, нпр. (php_version: 7.2 is not offered on this product line). То је део према којем можете поступити — реченица испред њега је намерно уопштена.

Верификујте своје преузимање

Свака архива се испоручује преко TLS-а са нашег сопственог назива хоста и никада се не преусмерава на хост треће стране. Њен SHA-256 контролни збир је одштампан поред везе за преузимање на страници за преузимања. Упоредите га након преузимања:

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

Не користите WHMCS?

Постоји HostBill модул и PHP клијент у једној датотеци за све остало, оба бесплатна и оба на истој страници за преузимања. Свака крајња тачка коју модули користе налази се у API референци.

Најновије са блога

О чему смо писали када је реч о хостингу, SEO-у и вођењу сајтова великих размера.

SEO и изградња линкова са хостинг слоја: поглед оператера за 2026. годину

Како хостинг утиче на индексирање и вредност линкова у 2026. години: одржавање страница индексираним, провера старих домена пре израде сајтова на њима, изградња линкова без отиска (footprint-а) и искрен осврт на то шта инфраструктура може, а шта не може да учини за SEO.

Прочитајте чланак →

Како учинити WordPress брзим и безбедним: Контролна листа за перформансе и прикључке

Практична контролна листа за брз и безбедан WordPress: кеширање на нивоу сервера, кеш објеката по сајту, неколицина додатака вредних коришћења, одржавање стека ажурним и WooCommerce странице које никада не смете кеширати.

Прочитајте чланак →

Како изабрати управљани веб-хостинг у 2026. години: Водич за купце

Шта заправо разликује добар управљани хостинг од јефтиног сервера са контролним панелом — миграције, резервне копије, изолација, право кеширање и поштено скалирање — и како да то процените пре него што се обавежете.

Прочитајте чланак →

Прочитајте блог →

И даље сте заглављени?

Подршка је укључена у сваки план, служба је отворена 24 сата дневно и можете нам писати на било ком од наших 58 језика — одговарамо вам на вашем језику.

Контактирајте подршку Сви чланци