Sayar da bakuncin Zinn® daga WHMCS

Modul ɗin Zinn Digital® yana mayar da maɓallan WHMCS na kansa su zama ayyuka na zahiri a kan dandalinmu. Oda tana tanadar da daren karɓar baƙuncin gidan yanar gizo (hosting) na abokin cinikinku. Na'urar sarrafa kanta ta daftarin kuɗi da ya wuce lokacinsa ta WHMCS tana dakatar da shi. Sanya alamar cewa an biya daftarin kuɗin yana sakin shi. Sokewa tana tsara lokacin gogewa. Kuma abokin cinikinku yana samun maɓallin Log in to hosting panel a shashen abokin cinikinsu wanda ke shigar da su kai tsaye.

Yana da kyauta, yana da lasisin GPL-2.0-or-later, kuma ba shi da wata hanyar alfarma ta musamman zuwa dandalinmu: kowane kira da yake yi a rubuce yake a matsayin endpoint wanda za ku iya yi da kanku ta amfani da maɓallin API ɗinku na kanku.

Kafin ku fara

Kuna buƙatar abubuwa biyu, kuma na biyun yana yaudarar mutane.

1. Asusun dillali (reseller) na Zinn® mai ɗauke da shiri mai aiki. Yi rajista a

zinndigital.com sannan ku kunna tsarin dillanci.

2. Tsarin dillali mai izinin adadin shafukan yanar gizo. Shafukan da abokan cinikinku suka yi oda suna ragewa daga tsarin ku,

don haka kuna buƙatar wanda ke da sauran gurabe a ciki.

⚠️ Test Connection ba zai iya gaya muku ko oda za ta yi nasara ba. Yana karanta shirin ku ne kawai kuma baya tanadar da komai, don haka yana ba da rahoton cewa asusun yana da lafiya kuma yana active amma kuma har yanzu ba zai iya sayar da komai ba. Idan odarku ta farko ta faskara tare da saƙon "This organization has no hosting plan, so it cannot host a site yet", abin da ya faru ke nan — ku sayi ko ku tsawaita tsarin dillalanku sannan ku sake tura odar. Babu wata matsala game da modul ɗin.

1. Ƙirƙiri maɓallin API

A cikin allon sarrafawa (dashboard) na Zinn® ɗinku, buɗe API keys sannan ku ƙirƙiri guda ɗaya tare da ainihin waɗannan izini guda goma sha ɗaya:

⛔ Kada ku bayar da izinin reseller.manage. Maɓallin da aka liƙa a cikin allon lissafin kuɗi ya kamata ya iya riƙe abokin ciniki saboda rashin biyan kuɗi da kuma shigar da su ciki. Bai kamata ya iya karantawa da sake rubuta bayanan hanyoyin biyan kuɗinku na kanku ba. reseller.provision yana nan ne domin kada ku bayar da babban izinin. ⛔ org.create ba na zaɓi ba ne. Idan ba tare da shi ba, modul ɗin zai iya karanta asusunku amma ba zai iya buɗe sabo ba, don haka Test Connection zai yi nasara amma oda ta farko za ta ba da amsar 403. ⛔⛔ Bayar da dukkan izinin da ke kan teburin, kuma ku sani cewa Test Connection ba zai iya gaya muku ba idan ba ku yi hakan ba. Yana karanta shirin dillalanku ne kawai kuma baya tanadar da komai, don haka yana nuna kore koda maɓallin yana rasa ɗaya daga cikin waɗannan. Abin da za ku samu a maimakon haka shi ne 403 a kan aiki guda ɗaya da izinin da ya ɓace ke da alhakin sa, watanni bayan haka, daga wani abokin ciniki.

2. Sanya modul ɗin

1. Sauke modul ɗin sannan ku buɗe zip ɗin (unzip).
2. Loda babban fayil ɗin (directory) zinn a cikin manhajar WHMCS ɗinku domin fayil ɗin modul ɗin ya sauka a

modules/servers/zinn/zinn.php.

⛔ Dole ne a sanya wa babban fayil ɗin suna zinn. WHMCS tana ciro sunayen ayyukan modul ɗin tanadi daga sunan babban fayil ɗinsa, don haka sake masa suna zuwa zinn-whmcs ko zinndigital zai samar da modul ɗin da WHMCS ke jerawa, ta ba ku damar zaɓa, amma kuma ba za ta taɓa kiransa ba — ba tare da wani kuskure a ko'ina ba. Zip ɗin ya riga ya buɗe da ainihin sunan da ya dace; kawai kada ku sake masa suna.

3. Ƙara uwar garken (server)

A cikin WHMCS: Configuration → System Settings → Servers → Add New Server.

• Name: kowane suna, misali Zinn Digital®
• Hostname: api.zinndigital.com
• Type: Zinn Digital®
• Password: maɓallin API ɗinku daga mataki na 1

⛔ Maɓallin yana shiga ne a filin Password, wanda WHMCS ke adanawa a ɓoye (encrypted). Kada ku sanya shi a cikin zaɓin tsarin samfuri (product configuration option) — waɗannan a rubuce suke a sarari a cikin rumbun adana bayanai kuma kowane mai gudanarwa yana iya ganinsu, alhali wannan bayanin sirri na iya ƙirƙira da kuma lalata daren karɓar baƙuncin gidajen yanar gizo na abokan cinikinku.

Danna Test Connection. Yana yin ainihin kira ne kuma yana ba da rahoton abin da dandalinmu ya ce, maimakon kawai duba ko an cika filayen.

4. Ƙirƙiri samfurin

Configuration → System Settings → Products/Services, sannan ku saita Module Settings zuwa uwar garken da kuka ƙara yanzu. Filayen sune:

⛔⛔ Ana buƙatar lambar tsari (Plan code), kuma da gangan ake ƙin amincewa da odar da ba ta da shi. Har zuwa 2026-09-01 filin na ado ne kawai kuma babu abin da ke karanta shi, don haka modul ɗin ya yi odar hosting wanda ba shi da ko wane tsari kwata-kwata — kuma kowane sakamako na hakan ya kasance a ɓoye. Sanarwar kuɗin sarinku an gina ta ne daga ingantattun biyan kuɗi na abokan cinikinku na yanzu, saboda haka babu wani layi na sabis ɗin kuma ba a tura muku daftarin biyan kuɗi na komai ba muddin yana aiki; abokin cinikinku bai gaji kowane irin izini ba, don haka ba a yi amfani da ƙa'idar iyakar diski ko fayil a shafinsu ba; kuma Change Package ba shi da abin da zai canza, don haka ba za a iya aiwatar da haɓakawar da kuka sayar ba. Shafin ya tanadu kuma ya yi aiki yadda ya kamata a duk tsawon lokacin.

Modul ɗin yanzu yana ƙin amincewa da odar a maimakon haka, saboda babu wani tsari mai aminci da zai iya ƙiyasta: ƙiyasi zai tanadar da hosting a kan tsarin da ba ku zaɓa ba kuma wataƙila ba ku sanya masa farashi ba, kuma — ba kamar ƙin amincewa ba, wanda kuke gani nan take — zai bayyana ne kawai lokacin da sanarwar lissafin kuɗi ta zo, idan ma ta zo.

Saita Auto Setup zuwa duk wanda kuka fi so — modul ɗin idempotent ne a kan id na sabis na WHMCS, don haka sake gwada tanadi yana dawo da shafi ɗaya ne maimakon caje ku kuɗin na biyu.

Abin da kowane aikin WHMCS yake yi

Haɓakawa: wanene ke cajin wane

Zinn® ba ta taɓa tura wa abokin cinikinku daftarin kuɗi ba, a kan oda ko a kan haɓakawa. Kuna caje su ne ta hanyar WHMCS; mu kuma muna caje ku, a kan sanarwar lissafin kuɗin sarinku. Don haka Change Package yana canza haƙƙoƙin abokin cinikinku da layin da ke kan sanarwarku ta gaba, kuma baya taɓa katin kowa — WHMCS ta riga ta karɓi kuɗin abokin cinikinku kuma ta ƙididdige rabon kuɗinta na kanta.

Sabis na biyu na abokin ciniki. A kan tsari iri ɗaya wani shafi ne na daban a ƙarƙashin izinin adadin shafin na wannan tsarin, kuma babu wani abu ƙari da ake bayarwa. A kan tsari daban an ƙi amincewa da shi: maye gurbin tsarin da ke aiki zai bar ɗaya daga cikin sabis ɗin biyu ba tare da an caje shi ba. Ko dai ku sayar da duka biyun a kan tsari iri ɗaya, ko kuma ku kafa abokin cinikin a matsayin bayanan abokin ciniki daban a cikin WHMCS.

Change Password yana aiki ne kawai don WordPress. Hosting ɗin Zinn® ba shi da "kalmar sirri ta sabis" guda ɗaya — abokin cinikinku yana shiga allonsu ne ta hanyar maɓallin shiga — kuma shafin php ko static ba shi da asusun manhaja da za a canza. WHMCS tana ɓoye akwatin gaba ɗaya maimakon nuna wanda ba zai iya aiki ba.

Amsoshi guda uku da bai kamata ku maida su biyu ba

• Unsuspend na iya ba da amsa tare da ƙin amincewa. Hakan yana nufin cewa ƙungiyarmu mai kula da keta ƙa'idoji (abuse team) ce ta dakatar da shafin,

ba ku ba, kuma babu wani allon lissafin kuɗi da aka yarda ya sake shi. Saƙon ya faɗi haka; nuna shi ga mai gudanarwarku maimakon sake gwadawa.

• Terminate yana tsara lokacin gogewa ne, baya yin gogewar nan take. Kwanan watan yana dawowa a matsayin

pending_deletion_at kuma shashen abokin ciniki yana nuna shi. Gaya wa abokin ciniki cewa bayanansu sun riga sun tafi alhali ba haka ba ne ya fi muni da rashin gaya musu komai.

• Diski da bandwidth na iya zama ba a sani ba, kuma rashin sani ba yana nufin sifiri ba ne. Lokacin da ba mu sami damar ɗaukar

karatun ba, modul ɗin yana barin adadin a yadda yake maimakon rubuta 0 — in ba haka ba WHMCS za ta nuna wa abokin cinikinku sandar amfani mai kwantar da hankali wadda ke wofi don shafin da ba mu da karatunsa.

Magance matsala

Test Connection ya yi nasara amma oda ta farko ta faskara tare da kuskuren izini. Maɓallin API ɗin yana rasa org.create. Dole ne modul ɗin ya buɗe asusun abokin cinikin kafin ya iya ƙirƙirar shafinsu.

Oda ta faskara tana cewa ƙungiyar ba ta da tsarin hosting. Tsarin dillalanku ba shi da sauran izinin shafi da ya rage, ko kuma har yanzu ba ku da shi. Duba Kafin ku fara a sama.

Oda ta faskara tana ambaton stack. Filin Stack a kan samfurin a wofi yake ko kuma ya ambaci wani abu da ba ma ginawa. Saita shi zuwa wordpress sai dai idan kuna sayar da wani abu daban.

Sokewa tana faskara. Tabbatar cewa kuna kan sigar modul 1.0.0 ko kuma ta gaba. Sigogin da suka gabata ba su aika tabbacin gogewa ba kuma an ƙi amincewa da kowane tsayarwa, wanda ya bar sabis ɗin yana aiki kuma yana ci gaba da caji.

Ƙin amincewa da ke ambaton wani fili. Kura-kuran tabbatarwarmu suna ambaton filin da dalilin a cikin baka bayan saƙon, misali (php_version: 7.2 is not offered on this product line). Wannan shi ne rabin da za a iya ɗaukar mataki a kansa — jumlar da ke gabansa an yi ta ne da gangan a matsayin gama-gari.

Tabbatar da abin da kuka sauke

Ana bayar da kowane ma'ajiyar fayiloli (archive) ta hanyar TLS daga ainihin sunan uwar garkenmu kuma ba a taɓa tura shi zuwa uwar garken wani ɓangare na uku ba. An buga SHA-256 checksum ɗinsa a kusa da hanyar saukewa a kan shafin saukewa. Kwatanta shi bayan saukewa:

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

Ba ku kan WHMCS ba?

Akwai modul ɗin HostBill da kuma PHP client na fayil guda ɗaya don kowane abu daban, duka kyauta ne kuma duka suna kan shafin saukewa ɗaya. Kowane endpoint da modul ɗin ke amfani da shi yana cikin bayanin API.