Sayar da madogaran Zinn® daga tsarin ku na kanku

Kana sayar da sabis na daukar yanar gizo (hosting) namu. Abokan cinikin ku naku ne: farashin ku, rasidodin ku, mai ba da sabis na biyan kuɗi na ku. Haka kuke sarrafa dandalinmu daga duk abin da kuke da shi a yanzu — rukunin lissafin kuɗi, shafin ku na WordPress, ko wani rubutu (script).

Abin da abokan cinikin ku ke gani a zahiri

Kafin hanyoyin sadarwa: abokan cinikin ku ba za su taba ganin mu ba. Yankuna uku ne, kuma kun zabi wanda za ku yi amfani da shi.

| Yanki | Na wa ne | |---|---| | Rukunin daukar yanar gizo (hosting), a kan sunan mai masaukin baki (hostname) naku | Sanya sunan mai masaukin baki na rukunin karkashin Reselling → Your brand kuma abokan cinikin ku za su shiga a panel.yourcompany.com tare da tambarin ku da launukan ku. Hakanan rukunin, adireshin ku. | | Gidan yanar gizon ku | Kayan aikin WordPress (plugin) yana sanya binciken yanki da hanyar shiga ta danna-daya a shafin ku, kuma yana karɓar odar ta wurin rajistar fitowa (checkout) na WooCommerce naku. | | Rukunin lissafin kuɗi (billing panel) naku | WHMCS ko HostBill ya kasance kofa ta gaba; naúrar (module) tana shirya komai a bayanta kuma maballin yanki na abokin ciniki yana shigar da su kai tsaye cikin daukar yanar gizon su. |

⛔ Ko wanne kuka zaɓa, ku ne ke da alhakin ciniki (merchant of record) ga abokan cinikin ku: farashin ku, rasidodin ku, lambar VAT ta ku, mai ba da sabis na biyan kuɗi na ku. Muna lissafin ku ku, sau ɗaya a wata, a kan farashin jumloli.

Da zaran kun saita sunan mai masaukin baki (hostname) na rukunin, sanya shi a cikin filin Panel address na kayan aikin WordPress kuma a wani abu ba — hanyoyin shiga da wannan API ke samarwa suna bin sa ta atomatik.

Hanyoyi hudu na shiga

Akwai hanyoyi hudu na shiga, kuma dukansu suna yin abu guda a karkashinsa:

| | Don | |---|---| | Naúrar WHMCS | Shagon WHMCS | | Naúrar HostBill | Shagon HostBill | | Kayan aikin WordPress | Sayarwa daga shafin WordPress ko WooCommerce naku | | API | Duk wani abu daban — Blesta, tsarin gida, rubutun cron |

1. Samun madogaran API (API key)

A cikin allon sarrafa ku (dashboard), je zuwa API keys kuma ku ƙirƙiri ɗaya. Ba shi abin da kawai yake bukata:

| Izini | Dalili | |---|---| | org.read | Karanta asusun abokin cinikin ku | | sites.create | Shirya wani shafi | | sites.view | Karanta wani sabis | | sites.delete | Kashewa | | reseller.view | Lissafa sabis ɗin ku kuma karanta amfani | | reseller.provision | Dakatarwa, saki, da shigar da abokin ciniki |

⛔ Kada ku ba wa wani haɗin gwiwa izinin reseller.manage. Wannan izinin yana gyara jerin farashin ku da takaddun shaidar hanyar biyan kuɗi naku. reseller.provision yana wanzuwa ne daidai domin madogaran da kuka liƙa a cikin rukunin lissafin kuɗi ko gidan yanar gizo ba sa buƙatar shi.

Ana nuna madogaran sau ɗaya kawai. Ajiye shi inda kuke adana sauran takaddun shaidar ku — kada a taɓa sanya shi a cikin fayil da sabar gidan yanar gizon ku ke bayarwa.

2. Yi kiran ku na farko

curl https://api.zinndigital.com/v1/reseller/services \
  -H "Authorization: Bearer zdk_live_…"

Wannan yana dawo da kowane sabis da kuka shirya, layin ɗaya a kowane shafi, tare da abokin ciniki da yake mallaka, matsayinsa, da abin da kuke caji a kansa. A kan sabon asusu yana da jerin da babu komai — wanda shine amsar da ta dace, ba kuskure ba ne.

3. Duk haɗin gwiwa, a cikin kira shida

LOKACI                KIRA
ana biyan oda         POST   /v1/orgs                                   sau ɗaya a kowane ABOKIN CINIKI
                      POST   /v1/sites                                  sau ɗaya a kowane SABIS
basu biya ba          POST   /v1/reseller/services/{siteId}/suspend
sun biya              POST   /v1/reseller/services/{siteId}/unsuspend
sun soke              DELETE /v1/sites/{siteId}
"shiga cikin hosting" POST   /v1/reseller/services/{siteId}/sso

Shiri (provisioning) kira ne guda biyu, kuma madogaran suna da muhimmanci:

# 1. asusun abokin ciniki — an tsara shi a kan ID ɗin ABOKIN CINIKIN ku
curl -X POST https://api.zinndigital.com/v1/orgs \
  -H "Authorization: Bearer zdk_live_…" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: account-4211" \
  -d '{"type":"customer","name":"Acme Ltd"}'

# 2. shafin su — an tsara shi a kan ID ɗin SABIS ɗin ku
curl -X POST https://api.zinndigital.com/v1/sites \
  -H "Authorization: Bearer zdk_live_…" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: service-9915" \
  -d '{"org_id":"<from step 1>","product_line":"mainstream","primary_domain":"acme.com"}'

Dokoki guda biyu da ke kashe kuɗi idan kun yi kuskure

1. Sanya asusun a kan ABOKIN CINIKIN ku da shafin a kan SABIS ɗin ku. Odar abokin ciniki ta biyu dole ne ta sauka a cikin asusun da ya riga ya samu. Sanya su duka a kan sabis ɗin kuma abokin ciniki ɗaya zai ƙare da asusu uku marasa alaƙa da rukunoni uku daban-daban.
2. Aika Idempotency-Key a kan kowane POST, wanda aka gina daga ID ɗin ku don abin. Kowane tsarin lissafi yana sake gwadawa — amsawar hanyar biyan kuɗi tana zuwa sau biyu, mai kula da tsarin yana sake gudanar da gazawar shiri, abokin ciniki yana danna sau biyu. Ba tare da madogaran ba ƙoƙari na biyu zai ƙirƙiri shafi na biyu kuma za a yi muku lissafi a kansa.

Amsoshi guda uku da kada ku mai da su biyu

• unsuspend zai iya bada amsar 409. Wannan yana nufin tawagar cin zarafi ta mu ce ke riƙe da shafin, ba ku ba. Nuna sakon; kada ku sake gwadawa.
• **Kashewa yana tsara goge bayanai, baya aiwatar da shi ba.** Kwanan watan yana dawowa a matsayin pending_deletion_at. Gaya wa abokin ciniki cewa bayanan su sun riga sun tafi alhali ba su tafi ba ya fi muni da rashin gaya musu komai.
• disk_used_bytes zai iya zama null, kuma null ba sifili ba ne. Yana nufin ba za mu iya awo ba, ba wai babu abin da aka yi amfani da shi ba. Tsallake shi — kada ku rubuta 0 a cikin bayanan ku, ko za ku nuna wa abokin ciniki mashigar amfani mai kore don shafin da ba ku da karatu daga gare shi.

4. Shigar da abokin ciniki

POST /v1/reseller/services/{siteId}/sso yana dawo da adireshin URL na amfani ɗaya wanda ke sanya abokin cinikin ku kai tsaye cikin asusun su, an riga an shigar da su.

⛔ Samar da shi lokacin da suka danna, kada ku taɓa yin hakan lokacin da kuke loda shafin. Hanyar haɗin yanar gizon ana amfani da ita sau ɗaya ce kuma tana ƙarewa a cikin mintuna, don haka hanyar haɗin da aka rubuta a cikin shafi tana ɓacewa a farkon duba shafin kuma ana barin ta a cikin kowane cache tsakanin ku da burusa (browser).

5. Shigar da naúrar maimakon haka

• WHMCS — kwafi naúrar zuwa modules/servers/zinn/, ƙara sabar wacce Kalmar sirri (Password) ta kasance madogaran API ɗin ku, kuma saita layin samfurin a kan samfurin. Danna Test Connection: yana yin kiran gaskiya kuma yana gaya muku abin da dandalin ya ce.
• HostBill — kwafi zuwa includes/modules/Hosting/zinn/ kuma haɗa shi ta Hanyar da ta dace.
• WordPress — Zinn® Reseller Toolkit: binciken yanki, hanyar shiga cikin daukar yanar gizon abokan cinikin ku, da shirya WooCommerce lokacin da aka biya oda. Buɗaɗɗen tushe a <https://github.com/Zinn-Digital/zinn-reseller-toolkit>, ko sauke shi daga Plugins a cikin allon sarrafa ku.

6. Fara amfani da shi a aikace (Go live)

Bincika waɗannan kafin ku karɓi odar gaskiya:

• Gwajin haɗin gwiwa ya wuce a kan naúrar, ko curl ɗin ku na farko ya dawo da jerin sunaye.
• Jerin farashin ku an saita shi (Reselling → Your prices).
• Hanyar biyan kuɗi ta haɗu (Reselling → Payment gateways) — abokan cinikin ku suna biyan ku, ta hanyar asusun ku.
• Cikakken bayanin kamfanin ku yana ciki (Reselling → Your company) ta yadda rasidodin abokin cinikin ku za su ɗauki sunan doka da lambar VAT, ba namu ba.
• Kun sanya oda ta gaskiya guda ɗaya tun daga farko har ƙarshe kuma kun kalli shafin yana bayyana.

Inda duk sauran abubuwan suke

Cikakken bayanin API — kowane ma'ajiyar ƙarshe (endpoint), wanda aka ƙirƙira daga ƙayyadaddun bayanai na mu, tare da izinin da kowanne ke bukata — yana a <https://zinndigital.com/developers/api>.