Sayar da bakuncin Zinn® daga tsarin kanku

Kuna sake sayar da bakuncinmu. Abokan cinikinku naku ne: farashinku, daftarin kuɗinku, mai karɓar biyan kuɗinku. Wannan shi ne yadda kuke tafiyar da dandamalinmu daga duk abin da kuke amfani da shi a yanzu — faifan lissafin kuɗi, rukunin yanar gizonku na WordPress, ko rubutun umarni (script).

Abin da abokan cinikinku ke gani a zahiri

Kafin bayanin yadda abin ke aiki: abokan cinikinku ba za su taɓa ganinmu ba. Wurare uku ne, kuma ku zaɓi wanda za ku yi amfani da shi.

⛔ Ko wanne kuka zaɓa, ku ne ɗan kasuwa na asali ga abokan cinikinku: farashinku, daftarin kuɗinku, lambar VAT ɗinku, mai karɓar biyan kuɗinku. Muna tura muku daftarin kuɗi ku, sau ɗaya a wata, a farashin sari.

Da zarar kun saita sunan uwar garken faifai, saka shi a cikin filin Adireshin faifai na ƙarin kayan aiki na WordPress kuma ba a cikin wani abu daban ba — mahadan shiga da wannan API ke ƙirƙira suna bin sa kai tsaye.

Hanyoyi huɗu na shiga

Akwai hanyoyi huɗu na shiga, kuma duk suna yin abu ɗaya a ƙasa:

1. Samu maɓallin API

A cikin allon sarrafawarku, je zuwa Maɓallan API kuma ku ƙirƙiri ɗaya. Ba shi abin da yake buƙata kaɗai:

⛔ Kada ku ba haɗin kai izinin reseller.manage. Wannan izinin yana gyara jerin farashinku da bayanan sirri na hanyar biyan kuɗinku kanku. reseller.provision yana nan ne musamman domin maɓallin da kuka manna a cikin faifan lissafin kuɗi ko rukunin yanar gizo ba ya buƙatar sa.

Ana nuna maɓallin sau ɗaya kawai. Ajiye shi a inda kuke ajiye sauran bayanan sirrinku — kada a taɓa ajiye shi a cikin fayil ɗin da uwar garken yanar gizonku 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 duk sabis ɗin da kuka tanada, layi ɗaya a kowane shafi, tare da abokin cinikin da yake nasa, matsayinsa, da abin da kuke caji a kansa. A sabon asusu jeri ne mara komai — wanda shi ne amsa daidai, ba kuskure ba.

3. Duka haɗin gwiwar, a cikin kira shida

YOUSHE               KIRA
an biya oda          POST   /v1/orgs                                   sau ɗaya a kowane ABOKIN CINIKI
                     POST   /v1/sites                                  sau ɗaya a kowane SABIS
ba su biya ba        POST   /v1/reseller/services/{siteId}/suspend
sun biya             POST   /v1/reseller/services/{siteId}/unsuspend
sun soke             DELETE /v1/sites/{siteId}
"shiga cikin bakunci" POST   /v1/reseller/services/{siteId}/sso

Yin tanadi kira biyu ne, kuma maɓallan suna da mahimmanci:

# 1. asusun abokin ciniki — an ɗaure shi a kan lambar shaida ta ABOKIN CINIKINKU
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. shafinsu — an ɗaure shi a kan lambar shaida ta SABIS ƊINKU
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 biyu masu cin kuɗi idan kuka yi kuskurensu

1. Haɗa asusun da ABOKIN CINIKINKU kuma shafin da SABIS ƊINKU. Oda ta biyu ta abokin ciniki dole ne ta shiga cikin asusun da suke da shi a yanzu. Haɗa duka biyun da sabis kuma abokin ciniki ɗaya zai ƙare da asusu uku marasa alaƙa da faifai daban-daban guda uku.
2. Aika Idempotency-Key a kowane POST, wanda aka gina daga lambar shaidarku kanku don abin. Kowane tsarin lissafin kuɗi yana sake gwadawa — kiran dawowa na hanyar biya yana zuwa sau biyu, mai gudanarwa yana sake gudanar da tanadin da ya gaza, abokin ciniki yana dannawa sau biyu. Ba tare da maɓallin ba ƙoƙari na biyu yana ƙirƙirar shafi na biyu kuma za a caje ku a kansa.

Amsoshi uku waɗanda bai kamata ku mayar da su biyu ba

• unsuspend na iya ba da amsar 409. Wannan yana nufin ƙungiyarmu ta cin zarafi ce ke riƙe da shafin, ba ku ba. Nuna saƙon; kada ku sake gwadawa.
• **Dakatar da aiki yana tsara sharewa ne, ba ya aiwatar da ɗaya kai tsaye.** Kwanan wata yana dawowa a matsayin pending_deletion_at. Gayawa abokin ciniki cewa bayanan su sun riga sun tafi alhali ba haka ba ya fi muni fiye da rashin gaya musu komai.
• disk_used_bytes na iya zama null, kuma null ba sifili ba ne. Yana nufin ba mu iya aunawa ba, ba wai ba a yi amfani da komai ba. Tsallake shi — kada ku rubuta 0 a cikin bayanan ku, ko za ku nuna wa abokin ciniki koren alamar amfani don shafin da ba ku da lissafin sa.

4. Shigar da abokin ciniki

POST /v1/reseller/services/{siteId}/sso yana dawo da URL mai amfani sau ɗaya wanda ke jefa abokin cinikinku kai tsaye cikin asusunsa, an riga an shigar da shi.

⛔ Ƙirƙire shi a lokacin da suka danna, kada ku taɓa yi yayin fitar da shafin. Mahadar ta amfani ɗaya ce kuma tana ƙarewa a cikin mintuna kaɗan, don haka mahadar da aka rubuta a cikin shafi tana ƙonewa a kallon shafi na farko kuma a bar ta a kowane ma'ajiyar bayanai (cache) tsakanin ku da burawzar.

5. Shigar da manhaja maimakon haka

• WHMCS — kwafi manhajar zuwa modules/servers/zinn/, ƙara uwar garke wadda Kalmar sirri ke maɓallin API ɗinku, kuma saita layin samfur a kan samfurin. Danna Gwajin Haɗi: yana yin ainihin kira kuma yana gaya muku abin da dandamalin ya ce.
• HostBill — kwafi zuwa includes/modules/Hosting/zinn/ kuma haɗa shi daidai haka.
• WordPress — Zinn® Reseller Toolkit: binciken yanki, mahadar shiga cikin bakuncin abokan cinikinku, da tanadin WooCommerce lokacin da aka biya oda. Buɗaɗɗiyar tushe a <https://github.com/Zinn-Digital/zinn-reseller-toolkit>, ko sauke shi daga Plugins a cikin allon sarrafawarku.

6. Fara aiki kai tsaye

Duba waɗannan kafin ku ɗauki ainihin oda:

• Gwajin haɗin yana wucewa akan manhajar, ko kuma curl ɗinku na farko ya dawo da jeri.
• An saita jerin farashinku (Sake sayarwa → Farashinku).
• An haɗa hanyar biyan kuɗinku (Sake sayarwa → Hanyoyin biyan kuɗi) — abokan cinikinku suna biyan ku, ta asusunku kanku.
• Cikakkun bayanan kamfaninku suna ciki (Sake sayarwa → Kamfaninku) don daftarin kuɗin abokin cinikinku ya ɗauki sunan ƙungiyarku ta doka da lambar VAT, ba namu ba.
• Kun sanya ainihin oda ɗaya tun daga farko har ƙarshe kuma kun kalli shafin yana bayyana.

Inda duk wani abu daban yake

Cikakken bayanin API — kowane mazaunin ƙarshe (endpoint), wanda aka ƙirƙira daga ƙayyadaddun bayananmu, tare da izinin da kowannensu ke buƙata — yana a <https://zinndigital.com/developers/api>.