WHMCS арқылы Zinn® хостинмін сату

Zinn Digital® модулі WHMCS-тің өзіндік түймелерін біздің платформамыздағы шынайы әрекеттерге айналдырады. Тапсырыс клиенттің хостинкін қамтамасыз етеді. WHMCS мерзімі өткен шот-фактураны автоматтандыру арқылы оны тоқтата тұрады. Шот-фактураны төленді деп белгілеу оны қайтарады. Болдырмау жоюды жоспарлайды. Ал сіздің клиентіңіз клиент аймағында оны бірден жүйеге кіргізетін Хостинг панеліне кіру түймесін алады.

Ол тегін, GPL-2.0-or-later лицензиясына ие және біздің платформаға артықшылықты жолы жоқ: ол жасайтын әрбір шақыру — өз API кілтіңізбен өзіңіз жасай алатын құжатталған соңғы нүкте.

Бастамас бұрын

Сізге екі нәрсе керек, және екіншісі адамдарды шатастырады.

Белсенді бағдарламасы бар Zinn® реселлер тіркелгісі. zinndigital.com сайтында тіркеліп, реселлер қызметін қосыңыз.
Сайт лимиті бар реселлер жоспары. Клиенттеріңіз тапсырыс беретін сайттар сіздің жоспарыңызға есептеледі, сондықтан сізге бос орны бар жоспар қажет.

⚠️ Қосылымды сынау (Test Connection) тапсырыстың сәтті болатынын не болмайтынын анықтай алмайды. Ол сіздің бағдарламаңызды оқиды және ештеңені қамтамасыз етпейді, сондықтан ол әлі ештеңе сата алмайтын қалыпты active тіркелгі туралы хабарлайды. Егер сіздің бірінші тапсырысыңыз "Бұл ұйымда хостинг жоспары жоқ, сондықтан ол әлі сайтты орналастыра алмай білмейді" деген қатемен сәтсіз аяқталса, бұл осының салдары — реселлер жоспарын сатып алыңыз немесе ұзартыңыз және тапсырысты қайта беріңіз. Модульде ешқандай ақау жоқ.

1. API кілтін жасау

Zinn® басқару панелінде API keys бөлімін ашып, дәл осы он бір рұқсаты бар біреуін жасаңыз:

| Рұқсат | Оның не үшін қажет екендігі | | -------------------- | ----------------------------------------------------------- | | 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. Модульді орнату

Модульді жүктеіп алыңыз және оны архивінен шығарыңыз.
Модуль файлы modules/servers/zinn/zinn.php жолына түсетін етіп zinn директориясын WHMCS орнатылымына жүктеңіз.

⛔ Директория zinn деп аталуы тиіс. WHMCS қамтамасыз ету модулінің функция атауларын оның директория атауынан алады, сондықтан оны zinn-whmcs немесе zinndigital деп өзгерту WHMCS тізімдейтін, таңдауға мүмкіндік беретін, бірақ ешқашан шақырмайтын модульді тудырады — еш жерде ешқандай қате көрсетілмейді. Zip архиві қажетті атаумен шығады; жай ғана оның атауын өзгертпеңіз.

3. Серверді қосу

WHMCS жүйесінде: Configuration → System Settings → Servers → Add New Server.

Name: кез келген атау, мысалы, Zinn Digital®
Hostname: api.zinndigital.com
Type: Zinn Digital®
Password: 1-қадамдағы API кілтіңіз

⛔ Кілт WHMCS шифрланған күйде сақтайтын Password өрісіне енгізіледі. Оны өнімді конфигурациялау опциясына қоймаңыз — олар дерекқорда ашық мәтін түрінде болады және әрбір әкімшіге көрінеді, ал бұл тіркелгі деректері клиенттеріңіздің хостинкін жасап, жоя алады.

Test Connection түймесін басыңыз. Ол өрістердің толтырылғанын тексерудің орнына нақты қоңырау шалып, платформамыздың не айтқанын хабарлайды.

4. Өнімді жасау

Configuration → System Settings → Products/Services, содан кейін Module Settings параметрін жаңа ғана қосқан серверге орнатыңыз. Өрістер мыналар:

| Өріс | Міндетті | Бұл не | | ---------------- | -------- | -------------------------------------------------------------------------- | | Product line | иә | Сіз сататын Zinn® желісі — mainstream (басқарылатын WordPress), footprint_free, wordpress, linux, cloud, agency, app_hosting, ai_hosting, lms_hosting, managed_database, vector_hosting, zinn_compute, fleet_linux, fleet_enterprise, mail немесе reseller. | | Stack | иә | Не құрастырылатыны: wordpress (әдепкі), woocommerce, php, static, node, one_click, headless_cms, nextcloud немесе owncloud. | | Application | жоқ | Тек one_click және headless_cms стектері үшін — қандай қолданбаны орнату керек. Басқа стектерде біреуін атаудан бас тартылады, өйткені бұл стек не орнатылатынын өзі шешіп қойған. | | PHP version | жоқ | мысалы, 8.3. Желінің әдепкі мәні үшін бос қалдырыңыз. Желі ұсынбайтын нұсқа ол ұсынатын нұсқалардың тізімімен бірге қабылданбайды. | | Plan code | иә | Бұл өнім сататын Zinn® жоспары. GET /v1/reseller/prices сіздікін көрсетеді. Онысыз жасалған тапсырыс қабылданмайды — төмендегі ескертуді қараңыз. | | Billing interval | жоқ | monthly (әдепкі) немесе annual — бұл клиент үшін сіздің көтерме желіңіз есептелетін интервал. Өз клиентіңізден алатын ақы WHMCS өнімінде орнатылады және оған еш әсер етпейді. |

⛔⛔ Plan code міндетті болып табылады және онсыз тапсырыс қасақана қабылданбайды. 2026-09-01 дейін өріс декоративті болды және оны ешкім оқымады, сондықтан модуль ешқандай жоспары жоқ хостингке тапсырыс берді — және оның әрбір салдары еш хабарсыз қалды. Көтерме есебіңіз клиенттеріңіздің белсенді жазылымдарынан құрылады, сондықтан қызмет үшін ешқандай жол болмады және ол жұмыс істеген уақыт бойы сізге ешқандай шот жазылмады; клиентіңіз ешқандай лимиттер алмады, сондықтан сайтына ешқандай диск немесе файл квотасы қолданылмады; және Пакетті өзгерту (Change Package) ешнәрсені өзгертпеді, сондықтан сіз сатқан жаңартуды орындау мүмкін болмады. Сайт бүкіл уақыт бойы мінсіз жұмыс істеді және қызмет көрсетті.

Модуль қазір оның орнына тапсырыстан бас тартады, өйткені оның болжауы үшін қауіпсіз жоспар жоқ: болжау сіз таңламаған және бағасын белгілемеген болуы мүмкін жоспарда хостингті қамтамасыз етеді, және бірден оқитын бас тартудан айырмашылығы — бұл шотыңыз келген кезде ғана, егер келсе, көрінеді.

Auto Setup параметрін өзіңізге ұнайтынына орнатыңыз — модуль WHMCS қызмет идентификаторында идемпотентті болып табылады, сондықтан қайталанған провизинг сізге екінші рет ақы төлетпей, сол сайтты қайтарады.

Әрбір WHMCS әрекеті не істейді

| WHMCS әрекеті | Біздің тарапымызда не болады | | --------------------------- | ---------------------------------------------------------------------------------------- | | Create | Клиенттің Zinn® тіркелгісін жасайды (немесе оларда бар тіркелгіні қайта пайдаланады) және сайтына қамтамасыз етеді. | | Suspend | Сайтты төлемеу салдарынан бұғаттауға қояды. Мазмұны сақталады; ештеңе жойылмайды. | | Unsuspend | Сіздің бұғаттауыңызды алады. | | Terminate | Жеңілдік кезеңімен сайтты жоюды жоспарлайды. Күні клиент аймағында көрсетіледі. | | Usage update | Күніне бір рет әрбір қызметтегі диск пен өткізу қабілетін жаңартады. | | Log in to hosting panel | Клиенттің панеліне бір реттік, бір рет қолданылатын кіру сілтемесін ашады. | | Change Package | Қызметті жаңартады немесе төмендетеді. Пакетті және егер жаңа өнім біреуін атаса, PHP нұсқасын жылжытады. | | Change Password | WordPress әкімшісінің құпиясөзін орнатады. Бұл өріс мұндай тіркелгісі жоқ стектерде көрсетілмейді. | | Renew | Қызметтің әлі де бар екенін растайды. Zinn® хостингі үздіксіз болып табылады, сондықтан ұзартылатын қашықтағы мерзім жоқ. | | Sync Usage / Purge Cache / Take Backup | Әкімші қызметі бетіндегі түймелер. Клиентіңіз клиент аймағында Purge Cache және Take Backup функцияларын алады. | | Service tab | Күйі, жоспары, диск, өткізу қабілеті, кез келген жоспарланған жою және бұғаттауды кім қойғаны. | | Import | ListAccounts әрбір бетті оқиды, сондықтан импорт бірінші бетте байқусыз тоқтап қалмайды. |

Жаңартулар: кім кімге ақы төлетеді

Тапсырыс немесе жаңарту кезінде клиентіңізге ешқашан Zinn® тарапынан шот жазылмайды. Сіз оларға WHMCS арқылы шот жазасыз; біз сізге көтерме есебіңіз бойынша шот жазамыз. Сондықтан пакетті өзгерту клиентіңіздің құқықтарын және келесі есебіңіздегі жолды жылжытады, бірақ картаға тиіспейді — WHMCS клиентіңіздің ақшасын өзі алып, пропорционалды есептеуді орындап қойған.

Клиенттің екінші қызметі. Сол жоспарда бұл сол жоспардың өз сайт лимиті астындағы басқа сайт болып табылады және басқа ештеңе берілмейді. Басқа жоспарда ол қабылданбайды: тірі жоспарды ауыстыру екі қызметтің біреуін төленбеген күйде қалдырады. Екеуін де бір жоспарда сатыңыз немесе клиентті WHMCS жүйесінде бөлек клиент жазбасы ретінде орнатыңыз.

Change Password тек WordPress үшін ғана бар. Zinn® хостингінде жалғыз «қызмет құпиясөзі» жоқ — клиентіңіз панеліне кіру түймесі арқылы жетеді — ал php немесе static сайтында өзгертуге болатын қолданба тіркелгісі жоқ. WHMCS жұмыс істей алмайтын өрісті көрсетудің орнына оны толығымен жасырады.

Екіге айналдыруға болмайтын үш жауап

Unsuspend бас тарту жауабын беруі мүмкін. Бұл сайтты сіз емес, біздің алаяқтыққа қарсы командамыз бұғаттағанын білдіреді және ешқандай биллинг панелі оны босата алмай деректерді қайтармауы тиіс. Хабарлама мұны айтады; оны қайта көрудің орнына әкімшіңізге көрсетіңіз.
Terminate жоюды жоспарлайды, бірақ оны орындамайды. Күн pending_deletion_at ретінде қайтарылады және клиент аймағы оны көрсетеді. Тұтынушыға деректері әлі жойылмаса да, жойлып кетті деп айту ешнәрсе айтпағаннан да жаман.
Диск пен өткізу қабілеті белгісіз болуы мүмкін, ал белгісіз дегеніміз нөл емес. Біз көрсеткішті ала алмаған кезде модуль 0 деп жазудың орнына мәнді сол күйінде қалдырады — әйтпесе WHMCS бізде деректері жоқ сайт үшін тұтынушыңызға бос пайдалану жолағын көрсетер еді.

Ақаулықтарды жою

Test Connection сәтті өтеді және бірінші тапсырыс рұқсат қатесімен сәтсіз аяқталады. API кілтінде org.create жоқ. Модуль сайтты жасамас бұрын клиенттің тіркелгісін ашуы тиіс.

Тапсырыс ұйымда хостинг жоспары жоқ екенін айтып сәтсіз аяқталады. Реселлер жоспарыңызда сайт лимиті қалмаған немесе әлі жоспарыңыз жоқ. Жоғарыдагы Бастамас бұрын бөлімін қараңыз.

Тапсырыс стек туралы айтып сәтсіз аяқталады. Өнімдегі Stack өрісі бос немесе біз салмайтын нәрсені атайды. Басқа нәрсе сатпасаңыз, оны wordpress етіп орнатыңыз.

Болдырмаулар сәтсіз аяқталуда. Модульдің 1.0.0 немесе одан кейінгі нұсқасын пайдаланып жатқаныңызға көз жеткізіңіз. Ерте құрастырылымдар жоюды растауды жібермеді және әрбір тоқтату қабылданбады, бұл қызметтің жұмыс істеуін және ақы алуын жалғастырды.

Өріс атауын көрсететін бас тарту.

Біздің валдау қателеріміз хабарламадан кейін жақша ішінде өріс пен себебін көрсетеді, мысалы, (php_version: 7.2 is not offered on this product line). Бұл әрекет етуге болатын жартысы — оның алдындағы сөйлем әдейі жалпылама жасалған.

Жүктемеңізді тексеріңіз

Әрбір архив біздің жеке хосттан TLS арқылы беріледі және ешқашан үшінші тарап хостына бағытталмайды. Оның SHA-256 бақылау сомасы downloads page жүктеу сілтемесінің жанында басылған. Жүктеп алғаннан кейін оны салыстырыңыз:

macOS немесе Linux: shasum -a 256 zinn-whmcs-1.0.0.zip
Windows: certutil -hashfile zinn-whmcs-1.0.0.zip SHA256

WHMCS қолданбайсыз ба?

Басқа кез келген нәрсе үшін HostBill модулі және бір файлды PHP клиенті бар, екеуі ҳам тегін және downloads page сайтында орналасқан. Модульдер пайдаланатын әрбір соңғы нүкте API reference ішінде бар.