Kuuza upangishaji wa Zinn® kutoka mifumo yako mwenyewe

Unauza upya huduma yetu ya kupangisha tovuti. Wateja wako ni wako: bei zako, ankara zako, mtoa huduma wako wa malipo. Hivi ndivyo unavyoendesha jukwaa letu kutoka kwa chochote unachotumia tayari — paneli ya malipo, tovuti yako mwenyewe ya WordPress, au hati ya kikompyuta.

Kile ambacho wateja wako huona hasa

Kabla ya mambo ya kiufundi: wateja wako hawalazimiki kamwe kutuona sisi. Nyuso tatu, na wewe huchagua unayotumia.

⛔ Chochote utakachochagua, wewe ndiye mfanyabiashara rasmi kwa wateja wako: bei zako, ankara zako, nambari yako ya VAT, mtoa huduma wako wa malipo. Sisi tunakutoza wewe, mara moja kwa mwezi, kwa bei ya jumla.

Ukishamweka jina la mpangishaji wa paneli, liweke kwenye sehemu ya Anwani ya paneli ya programu-jalizi ya WordPress na si kwingineko — viungo vya kuingia vinavyotengenezwa na API hii huifuata kiotomatiki.

Njia nne za kuingia

Kuna njia nne za kuingia, na zote hufanya kitu kilekile kwa ndani:

1. Pata ufunguo wa API

Kwenye dashibodi yako, nenda kwenye Vifunguo vya API na uunde kimoja. Kipe kile tu kinachohitajika:

⛔ Usipe muunganisho ruhusa ya reseller.manage. Ruhusa hiyo huhariri orodha yako ya bei na vitambulisho vyako mwenyewe vya lango la malipo. reseller.provision ipo mahsusi ili ufunguo unaobandika kwenye paneli ya malipo au tovuti usihitaji ruhusa hiyo.

Ufunguo huonyeshwa mara moja tu. Uhifadhi mahali unapohifadhi vitambulisho vyako vingine — usiwahi kuuweka kwenye faili inayotolewa na seva yako ya wavuti.

2. Fanya wito wako wa kwanza

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

Hiyo inarudisha kila huduma uliyoiandaa, safu moja kwa kila tovuti, ikiwa na mteja anayemilikiwa nayo, hali yake, na kile unachotoza kwa ajili yake. Kwenye akaunti mpya ni orodha tupu — ambalo ndilo jibu sahihi, si hitilafu.

3. Muunganisho wote, katika miito sita

WAKATI               WITO
agizo limelipwa      POST   /v1/orgs                                   mara moja kwa kila MTEJA
                     POST   /v1/sites                                  mara moja kwa kila HUDUMA
hawajalipa           POST   /v1/reseller/services/{siteId}/suspend
wanalipa             POST   /v1/reseller/services/{siteId}/unsuspend
wanaghairi           DELETE /v1/sites/{siteId}
"ingia kwenye host"  POST   /v1/reseller/services/{siteId}/sso

Uandaaji wa huduma ni miito miwili, na funguo zina umuhimu:

# 1. akaunti ya mteja — ikiwa na ufunguo wa kitambulisho chako cha MTEJA
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. tovuti yao — ikiwa na ufunguo wa kitambulisho chako cha HUDUMA
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"}'

Sheria mbili zinazogharimu pesa unapozikosea

1. Weka ufunguo wa akaunti kwenye MTEJA wako na tovuti kwenye HUDUMA yako. Agizo la pili la mteja lazima liingie kwenye akaunti aliyonayo tayari. Ukiweka zote mbili kwenye huduma, mteja mmoja ataishia kuwa na akaunti tatu zisizohusiana na paneli tatu tofauti.
2. Tuma Idempotency-Key kwenye kila POST, iliyoundwa kutoka kwa kitambulisho chako mwenyewe cha kitu hicho. Kila mfumo wa malipo hujaribu tena — mrejesho wa lango hufika mara mbili, msimamizi anarudia uandaaji ulioshindwa, mteja anabofya mara mbili. Bila ufunguo huo jaribio la pili huunda tovuti ya pili na unatozwa kwa ajili yake.

Majibu matatu ambayo hupaswi kuyapunguza kuwa mawili

• unsuspend inaweza kujibu 409. Hiyo inamaanisha timu yetu ya udhibiti wa matumizi mabaya inashikilia tovuti, si wewe. Onyesha ujumbe huo; usijaribu tena.
• **Kusitisha kabisa hupanga ratiba ya ufutaji, haifuti papo hapo.** Tarehe inarudi kama pending_deletion_at. Kumwambia mteja kuwa data yake imeshaondolewa wakati haijaondolewa ni mbaya zaidi kuliko kutomwambia chochote.
• disk_used_bytes inaweza kuwa null, na null si sifuri. Inamaanisha hatukuweza kupima, si kwamba hakuna kilichotumiwa. Iruke — usiandike 0 kwenye kumbukumbu zako mwenyewe, la sivyo utamwonyesha mteja upau wa kijani wa matumizi kwa tovuti ambayo huna kipimo chake.

4. Ingiza mteja kwenye akaunti

POST /v1/reseller/services/{siteId}/sso inarudisha URL ya matumizi ya mara moja inayompeleka mteja wako moja kwa moja kwenye akaunti yake mwenyewe, akiwa tayari ameingia.

⛔ Itengeneze wanapobofya, kamwe usiitengeneze wakati unatoa ukurasa. Kiungo hiki ni cha matumizi ya mara moja na huisha muda wake ndani ya dakika chache, kwa hivyo kiungo kilichoandikwa kwenye ukurasa kinatumika mara ya kwanza ukurasa unapotazamwa na kubaki katika kila hifadhi ya muda (cache) kati yako na kivinjari.

5. Sakinisha moduli badala yake

• WHMCS — nakili moduli kwenye modules/servers/zinn/, ongeza seva ambayo Nenosiri lake ni ufunguo wako wa API, na uweke mstari wa bidhaa kwenye bidhaa. Bonyeza Jaribu Muunganisho: inafanya wito halisi na kukuambia kile jukwaa lilichosema.
• HostBill — nakili kwenye includes/modules/Hosting/zinn/ na uiunganishe kwa njia hiyohiyo.
• WordPress — Zinn® Reseller Toolkit: utafutaji wa kikoa, kiungo cha kuingia kwenye upangishaji wa wateja wako, na uandaaji wa WooCommerce wakati agizo linapolipiwa. Ni chanzo huria katika <https://github.com/Zinn-Digital/zinn-reseller-toolkit>, au ipakue kutoka kwa Programu-jalizi kwenye dashibodi yako.

6. Anza kutumia rasmi

Kagua haya kabla ya kupokea agizo halisi:

• Jaribio la muunganisho limefaulu kwenye moduli, au curl yako ya kwanza inarudisha orodha.
• Orodha yako ya bei imewekwa (Uuzaji upya → Bei zako).
• Lango lako la malipo limeunganishwa (Uuzaji upya → Malango ya malipo) — wateja wako wanakulipa wewe, kupitia akaunti yako mwenyewe.
• Maelezo ya kampuni yako yamewekwa (Uuzaji upya → Kampuni yako) ili ankara za wateja wako zibebe taasisi yako ya kisheria na nambari ya VAT, si zetu.
• Umeweka agizo moja halisi kuanzia mwanzo hadi mwisho na ukaona tovuti ikitokea.

Mahali vilipo vitu vingine vyote

Marejeleo kamili ya API — kila kituo cha mwisho, kilichotengenezwa kutoka kwa ubainisho wetu, kikiwa na ruhusa inayohitajika na kila kimoja — yapo kwenye <https://zinndigital.com/developers/api>.