myဘာသာစကား
အခမဲ့ စတင်ပါ
အကောင့်ဝင်ရန်အခမဲ့ စတင်ပါ

ဗဟုသုတအခြေခံ

သင့်ကိုယ်ပိုင်စနစ်များမှ Zinn® ဟို့စ်တင်းကို ရောင်းချခြင်း

သင်၏ ကိုယ်ပိုင် ငွေတောင်းခံလွှာ ပန်နယ်၊ WordPress ဆိုက် သို့မဟုတ် စကေးများမှတစ်ဆင့် Zinn ဟော့စတင်းကို မောင်းနှင်ပါ- API ကီးတစ်ခု ရယူပါ၊ သင်၏ ပထမဆုံး ခေါ်ဆိုမှုကို ပြုလုပ်ပါ၊ ထို့ပြင် ပေါင်းစပ်မှု တစ်ခုလုံးအတွက် လိုအပ်သည့် ခေါ်ဆိုမှု ခြောက်ခုကို ပြုလုပ်ပါ။

သင်သည် ကျွန်ုပ်တို့၏ ဟော်စတင်းဝန်ဆောင်မှုကို ပြန်လည်ရောင်းချနေသူ (reseller) ဖြစ်သည်။ သင့်ဖောက်သည်များသည် သင့်လူများသာဖြစ်သည်- သင့်ဈေးနှုန်းများ၊ သင့်ပြေစာများ၊ သင့်ငွေပေးချေမှု ပံ့ပိုးပေးသူ (payment provider)။ ဤနည်းဖြင့် သင်အသုံးပြုပြီးသား မည်သည့်စနစ်မှမဆို (ဘီလ်တောင်းသည့် ပန်နယ်လ်၊ သင့်ကိုယ်ပိုင် WordPress ဆိုက် သို့မဟုတ် စာရင်းစကရစ်တစ်ခု) မှတစ်ဆင့် ကျွန်ုပ်တို့၏ ပလပ်ဖောင်းကို မောင်းနှင်နိုင်ပါသည်။

သင့်ဖောက်သည်များ အမှန်တကယ် မြင်တွေ့ရမည့်အရာ

စက်ပိုင်းဆိုင်ရာ လုပ်ဆောင်ချက်များ မတိုင်မီ: သင့်ဖောက်သည်များသည် ကျွန်ုပ်တို့ကို လုံးဝမြင်တွေ့ရမည် မဟုတ်ပါ။ မျက်နှာပြင် သုံးခုရှိပြီး သင်အသုံးပြုလိုရာကို ရွေးချယ်နိုင်ပါသည်။

| မျက်နှာပြင် | ပိုင်ဆိုင်သူ | |---|---| | သင့်ကိုယ်ပိုင် ဟိုစ်နိမ်း (hostname) ရှိ ဟော်စတင်း ပန်နယ်လ် | Reselling → Your brand အောက်တွင် ပန်နယ်လ် ဟိုစ်နိမ်း တစ်ခု သတ်မှတ်ပါ၊ သို့မှသာ သင့်ဖောက်သည်များသည် panel.yourcompany.com တွင် သင့်လိုဂို၊ သင့်အရောင်တို့ဖြင့် အကောင့်ဝင်ရောက်နိုင်မည် ဖြစ်သည်။ ပန်နယ်လ်သည် အတူတူပင်ဖြစ်သော်လည်း လိပ်စာကမူ သင့်လိပ်စာဖြစ်မည်။ | | သင့်ကိုယ်ပိုင် ဝဘ်ဆိုက် | WordPress ပလပ်ဂင်သည် ဒိုမိန်း ရှာဖွေမှုနှင့် တစ်ချက်နှိပ်ရုံဖြင့် အကောင့်ဝင်ရောက်နိုင်သည့် လင့်ခ်ကို သင့်ဆိုက်ပေါ်တွင် ထည့်သွင်းပေးပြီး သင့်ကိုယ်ပိုင် WooCommerce ငွေရှင်းစနစ် (checkout) မှတစ်ဆင့် အော်ဒါကို ရယူပေးသည်။ | | သင့်ဘီလ်တောင်းသည့် ပန်နယ်လ် | WHMCS သို့မဟုတ် HostBill သည် ပင်မတံခါးပေါက်အဖြစ် ဆက်လက်တည်ရှိနေမည်ဖြစ်ပြီး မော်ဂျူးက ၎င်း၏နောက်ကွယ်မှ ဆောင်ရွက်ပေးကာ ဖောက်သည်ဧရိယာခလုတ်က ၎င်းတို့အား ဟော်စတင်းဆိုက်သို့ တိုက်ရိုက် အကောင့်ဝင်ရောက်စေမည် ဖြစ်သည်။ |

⛔ သင်မည်သည့်အရာကို ရွေးချယ်သည်ဖြစ်စေ၊ သင်သည် သင့်ဖောက်သည်များအတွက် တရားဝင် ရောင်းချသူ (merchant of record) ဖြစ်သည်: သင့်ဈေးနှုန်းများ၊ သင့်ပြေစာများ၊ သင့် VAT နံပါတ်နှင့် သင့်ငွေပေးချေမှု ပံ့ပိုးပေးသူတို့သာ ဖြစ်ပါသည်။ ကျွန်ုပ်တို့သည် လက်ကားဈေးနှုန်းဖြင့် တစ်လလျှင် တစ်ကြိမ်သာ သင့်ကို ဘီလ်တောင်းခံပါမည်။

ပန်နယ်လ် ဟိုစ်နိမ်း တစ်ခုကို သတ်မှတ်ပြီးသည်နှင့် ၎င်းကို WordPress ပလပ်ဂင်၏ Panel address အကွက်ထဲတွင်သာ ထည့်ပါ၊ အခြားနေရာတွင် မထည့်ရပါ — ဤ API ဖန်တီးပေးသော အကောင့်ဝင်ရောက်သည့် လင့်ခ်များသည် ၎င်းကို အလိုအလျောက် လိုက်နာမည် ဖြစ်သည်။

ဝင်ရောက်နိုင်သည့် နည်းလမ်းလေးမျိုး

ဝင်ရောက်နိုင်သည့် နည်းလမ်းလေးမျိုး ရှိပြီး ၎င်းတို့အားလုံးသည် အောက်ခြေတွင် တူညီသော အလုပ်များကို လုပ်ဆောင်ကြသည်:

| | အတွက် | |---|---| | WHMCS မော်ဂျူး | WHMCS ဆိုင်တစ်ဆိုင် | | HostBill မော်ဂျူး | HostBill ဆိုင်တစ်ဆိုင် | | WordPress ပလပ်ဂင် | သင့်ကိုယ်ပိုင် WordPress သို့မဟုတ် WooCommerce ဆိုက်မှ ရောင်းချရန် | | API | အခြားမည်သည့်အရာမဆို — Blesta၊ ကုမ္ပဏီတွင်းသုံး စနစ်၊ cron စကရစ် |

၁။ API သော့ (key) တစ်ခု ရယူပါ

သင့် ဒါရှဘုတ်တွင်၊ API keys သို့သွား၍ တစ်ခု ဖန်တီးပါ။ လိုအပ်သည်များကိုသာ ပေးအပ်ပါ:

| ခွင့်ပြုချက် (Permission) | အကြောင်းရင်း | |---|---| | org.read | သင့်ဖောက်သည် အကောင့်များကို ဖတ်ရှုရန် | | sites.create | ဆိုက်တစ်ခုကို ပံ့ပိုးပေးရန် | | sites.view | ဝန်ဆောင်မှုတစ်ခုကို ဖတ်ရှုရန် | | sites.delete | ရပ်စဲရန် | | reseller.view | သင့်ဝန်ဆောင်မှုများကို စာရင်းပြုစုပြီး သုံးစွဲမှုကို ဖတ်ရှုရန် | | reseller.provision | ဖောက်သည်တစ်ဦးအား ဆိုင်းငံ့ခြင်း၊ ပြန်လည်လွှတ်ပေးခြင်းနှင့် အကောင့်ဝင်ခွင့်ပြုခြင်း |

⛔ ပေါင်းစပ်မှု (integration) တစ်ခုအား reseller.manage ကို မပေးပါနှင့်။ ထိုခွင့်ပြုချက်သည် သင့်ဈေးနှုန်းစာရင်းနှင့် သင့်ကိုယ်ပိုင် ငွေပေးချေမှု တံခါးပေါက် အထောက်အထားများကို တည်းဖြတ်ပေးပါသည်။ ဘီလ်တောင်းသည့် ပန်နယ်လ် သို့မဟုတ် ဝဘ်ဆိုက်တစ်ခုထဲသို့ သင်ထည့်လိုက်သော သော့တစ်မျိုးအတွက် ဤခွင့်ပြုချက် မလိုအပ်စေရန် reseller.provision ကို တိတိကျကျ ဖန်တီးထားခြင်း ဖြစ်သည်။

သော့ကို တစ်ကြိမ်သာ ပြသပါမည်။ ၎င်းကို သင်၏ အခြားအထောက်အထားများ သိမ်းဆည်းသည့်နေရာတွင် သိမ်းဆည်းပါ — ဝဘ်ဆာဗာမှ ဝန်ဆောင်မှုပေးသော ဖိုင်တစ်ခုထဲတွင် လုံးဝမသိမ်းဆည်းပါနှင့်။

၂။ သင်၏ ပထမဆုံးခေါ်ဆိုမှုကို ပြုလုပ်ပါ

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

၎င်းက သင်ပံ့ပိုးပေးထားသည့် ဝန်ဆောင်မှုအားလုံးကို ဆိုက်တစ်ခုလျှင် တစ်အတန်းစီဖြင့်၊ ၎င်းပါဝင်သည့် ဖောက်သည်၊ ၎င်း၏ အခြေအနေနှင့် သင်ကောက်ခံသည့် ဈေးနှုန်းတို့နှင့်အတူ ပြန်လည်ပေးပို့မည် ဖြစ်သည်။ အကောင့်အသစ်တစ်ခုတွင် ၎င်းသည် စာရင်းလွတ်တစ်ခု ဖြစ်နေမည်ဖြစ်ပြီး — ၎င်းသည် အမှားအယွင်းမဟုတ်ဘဲ မှန်ကန်သော အဖြေပင် ဖြစ်သည်။

3. ပေါင်းစပ်မှု တစ်ခုလုံးအတွက် ခေါ်ဆိုမှု ခြောက်ခု

WHEN                 CALL
an order is paid     POST   /v1/orgs                                   once per CUSTOMER
                     POST   /v1/sites                                   once per SERVICE
they have not paid   POST   /v1/reseller/services/{siteId}/suspend
they pay             POST   /v1/reseller/services/{siteId}/unsuspend
they cancel          DELETE /v1/sites/{siteId}
"log in to hosting"  POST   /v1/reseller/services/{siteId}/sso

ပံ့ပိုးပေးခြင်း (Provisioning) သည် ခေါ်ဆိုမှု နှစ်ခုပါဝင်ပြီး သော့များသည် အရေးကြီးသည်:

# 1. ဖောက်သည်၏ အကောင့် — သင့်ဖောက်သည်၏ ID ဖြင့် သော့ချက်သတ်မှတ်သည်
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. ၎င်းတို့၏ ဆိုက် — သင့်ဝန်ဆောင်မှု ID ဖြင့် သော့ချက်သတ်မှတ်သည်
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"}'

မှားယွင်းပါက ငွေကုန်ကြေးကျများစေမည့် စည်းမျဉ်း နှစ်ခု

  1. ဖောက်သည် (CUSTOMER) ပေါ်တွင် အကောင့်ကို သော့ချက်သတ်မှတ်ပြီး ဝန်ဆောင်မှု (SERVICE) ပေါ်တွင် ဆိုက်ကို သော့ချက်သတ်မှတ်ပါ။ ဖောက်သည်တစ်ဦး၏ ဒုတိယအော်ဒါသည် ၎င်းတို့တွင်ရှိပြီးသား အကောင့်ထဲသို့ ရောက်ရှိရမည် ဖြစ်သည်။ နှစ်ခုစလုံးကို ဝန်ဆောင်မှုပေါ်တွင် သော့ချက်သတ်မှတ်ပါက ဖောက်သည်တစ်ဦးတည်းတွင် ဆက်စပ်မှုမရှိသော အကောင့်သုံးခုနှင့် သီးခြားပန်နယ်လ်သုံးခု ရှိနေမည် ဖြစ်သည်။
  2. POST တိုင်းတွင် သင့်ကိုယ်ပိုင် ID မှ ဖန်တီးထားသော Idempotency-Key တစ်ခုကို ပို့ပါ။ ဘီလ်တောင်းသည့် စနစ်တိုင်းသည် ထပ်မံကြိုးစားတတ်ကြသည် — ငွေပေးချေမှု တံခါးပေါက်မှ အကြောင်းပြန်ကြားမှု (callback) နှစ်ကြိမ်ရောက်လာခြင်း၊ အက်ဒမင်က မအောင်မြင်ခဲ့သော ပံ့ပိုးမှုတစ်ခုကို ထပ်မံလုပ်ဆောင်ခြင်း၊ ဖောက်သည်က နှစ်ချက်နှိပ်ခြင်းတို့ ဖြစ်တတ်သည်။ သော့မပါပါက ဒုတိယအကြိမ် ကြိုးစားမှုသည် ဒုတိယဆိုက်တစ်ခုကို ဖန်တီးသွားမည်ဖြစ်ပြီး ၎င်းအတွက် သင် ငွေပေးဆောင်ရမည် ဖြစ်သည်။

အဖြေနှစ်ခုအဖြစ်သို့ လျှော့ချမထားသင့်သော အဖြေသုံးခု

  • unsuspend သည် 409 ဟု အဖြေပေးနိုင်သည်။ ၎င်းမှာ ကျွန်ုပ်တို့၏ မူလတန်းမဟုတ်သော အလွဲသုံးစားမှု စစ်ဆေးရေးအဖွဲ့က ဆိုက်ကို ထိန်းသိမ်းထားခြင်းကြောင့်ဖြစ်ပြီး သင်ကြောင့် မဟုတ်ပါ။ ထို မက်ဆေ့ဂျ်ကို ပြပါ၊ ထပ်မံမကြိုးစားပါနှင့်။
  • **ဖျက်သိမ်းခြင်း (Terminating) သည် ဖျက်ပစ်မည့်အချိန်ကို ဇယားဆွဲ ပေးခြင်းသာဖြစ်ပြီး၊ အမှန်တကယ် ဖျက်ပစ်ခြင်း မဟုတ်ပါ။** ရက်စွဲကို pending_deletion_at အဖြစ် ပြန်လည်ပေးပို့မည် ဖြစ်သည်။ ဖောက်သည်တစ်ဦး၏ အချက်အလက်များ မပျောက်သေးဘဲ ပျောက်သွားပြီဟု ပြောဆိုခြင်းသည် ဘာမှမပြောဘဲနေခြင်းထက် ပိုဆိုးပါသည်။
  • disk_used_bytes သည် null ဖြစ်နိုင်ပြီး null သည် သုည မဟုတ်ပါ။ ၎င်းမှာ ကျွန်ုပ်တို့ တိုင်းတာ၍မရခဲ့ခြင်းကို ဆိုလိုခြင်းဖြစ်ပြီး ဘာမှမသုံးခဲ့ခြင်းကို ဆိုလိုခြင်း မဟုတ်ပါ။ ၎င်းကို ကျော်သွားပါ — သင့်ကိုယ်ပိုင် မှတ်တမ်းများထဲသို့ 0 ဟု မရေးပါနှင့်၊ သို့မဟုတ်ပါက သင်စာဖတ်ရှုမှု မရှိသေးသော ဆိုက်တစ်ခုအတွက် ဖောက်သည်အား အစိမ်းရောင် သုံးစွဲမှုဘားတစ်ခုကို ပြသမိလိမ့်မည်။

4. ဖောက်သည်တစ်ဦးအား အကောင့်ဝင်ခွင့်ပြုပါ

POST /v1/reseller/services/{siteId}/sso သည် သင့်ဖောက်သည်အား ၎င်းတို့၏ ကိုယ်ပိုင်အကောင့်ထဲသို့ အကောင့်ဝင်ပြီးသားအနေအရာဖြင့် တိုက်ရိုက်ရောက်ရှိစေမည့် တစ်ကြိမ်သုံး URL တစ်ခုကို ပြန်လည်ပေးပို့သည်။

⛔ စာမျက်နှာကို ဖော်ပြသည့်အခါ မဟုတ်ဘဲ ၎င်းတို့နှိပ်သည့်အခါမှသာ ဖန်တီးပါ။ ဤလင့်ခ်သည် တစ်ကြိမ်သာသုံးနိုင်ပြီး မိနစ်ပိုင်းအတွင်း သက်တမ်းကုန်ဆုံးမည် ဖြစ်သောကြောင့် စာမျက်နှာတစ်ခုအတွင်း ရေးသားထားသော လင့်ခ်သည် ပထမဆုံး စာမျက်နှာကြည့်ရှုမှုတွင် အသုံးပြုပြီးသားဖြစ်သွားကာ သင်နှင့် ဘရောက်ဆာကြားရှိ ကက်ရှ် (cache) အားလုံးတွင် ကျန်ရှိနေမည် ဖြစ်သည်။

5. ယင်းအစား မော်ဂျူးတစ်ခုကို ထည့်သွင်းပါ

  • WHMCS — မော်ဂျူးကို modules/servers/zinn/ သို့ ကူးယူပါ၊ Password သည် သင့် API သော့ဖြစ်သည့် ဆာဗာတစ်ခုကို ထည့်ပါ၊ နှင့် ထုတ်ကုန်ပေါ်တွင် ထုတ်ကုန်လိုင်းကို သတ်မှတ်ပါ။ Test Connection ကို နှိပ်ပါ: ၎င်းသည် တကယ့်ခေါ်ဆိုမှုတစ်ခုကို ပြုလုပ်ပြီး ပလပ်ဖောင်းက ဘာပြောသည်ကို သင့်အား အကြောင်းကြားမည် ဖြစ်သည်။
  • HostBill — includes/modules/Hosting/zinn/ သို့ ကူးယူပြီး ၎င်းကို တနည်းတပုံတည်း ချိတ်ဆက်ပါ။
  • WordPress — Zinn® Reseller Toolkit: ဒိုမိန်း ရှာဖွေမှု၊ သင့်ဖောက်သည်များ၏ ဟော်စတင်းထဲသို့ ဝင်ရောက်မည့် အကောင့်ဝင်လင့်ခ်၊ နှင့် အော်ဒါပေးချေပြီးသောအခါ WooCommerce ပံ့ပိုးပေးခြင်းတို့ ဖြစ်သည်။ <https://github.com/Zinn-Digital/zinn-reseller-toolkit> တွင် အရင်းအမြစ်ဖွင့်ထားသည် (open source)၊ သို့မဟုတ် သင့်ဒါရှဘုတ်ရှိ Plugins မှ ဒေါင်းလုဒ်လုပ်ပါ။

6. တိုက်ရိုက်စတင်ပါ (Go live)

တကယ့်အော်ဒါတစ်ခုကို မရယူမီ ဤအချက်များကို စစ်ဆေးပါ:

  • မော်ဂျူးပေါ်ရှိ ချိတ်ဆက်မှု စမ်းသပ်မှု အောင်မြင်ခြင်း၊ သို့မဟုတ် သင်၏ ပထမဆုံး curl က စာရင်းတစ်ခုကို ပြန်လည်ပေးပို့ခြင်း။
  • သင့်ဈေးနှုန်းစာရင်း သတ်မှတ်ပြီးဖြစ်ခြင်း (Reselling → Your prices).
  • သင့်ငွေပေးချေမှု တံခါးပေါက် ချိတ်ဆက်ပြီးဖြစ်ခြင်း (Reselling → Payment gateways) — သင့်ဖောက်သည်များသည် သင့်ကိုယ်ပိုင်အကောင့်မှတစ်ဆင့် သင့်ထံ ငွေပေးချေရမည်။
  • သင့်ကုမ္ပဏီအသေးစိတ် အချက်အလက်များ ပါဝင်ပြီးဖြစ်ခြင်း (Reselling → Your company) ထို့ကြောင့် သင့်ဖောက်သည်ပြေစာများတွင် ကျွန်ုပ်တို့၏ နံပါတ်မဟုတ်ဘဲ သင့်တရားဝင်လုပ်ငန်းနှင့် VAT နံပါတ် ပါရှိမည်။
  • သင်သည် အစမှအဆုံး တကယ့်အော်ဒါ တစ်ခုကို ပြုလုပ်ခဲ့ပြီး ဆိုက်ပေါ်လာသည်ကို ကြည့်ရှုခဲ့ပြီးဖြစ်ခြင်း။

အခြားအရာများ ရှိရာနေရာ

ပြီးပြည့်စုံသော API ကိုးကားချက် — အဆုံးမှတ် (endpoint) တိုင်း၊ ကျွန်ုပ်တို့၏ သတ်မှတ်ချက်မှ ထုတ်လုပ်ထားပြီး တစ်ခုချင်းစီ လိုအပ်သော ခွင့်ပြုချက်တို့နှင့်အတူ <https://zinndigital.com/developers/api> တွင် ရှိပါသည်။

သေးနေတုန်းလား။

ပံ့ပိုးကူညီမှုကို ပလန်တိုင်းတွင် ထည့်သွင်းထားပြီး သင်၏ကိုယ်ပိုင်ဘာသာစကားဖြင့် အဖြေပေးပါသည်။

ပံ့ပိုးကူညီမှုကို ဆက်သွယ်ရန် → ဆောင်းပါးအားလုံး →

ဆိုဒ်ကို မည်သို့အသုံးပြုနေသည်ကို နားလည်ရန်အတွက် ကျွန်ုပ်တို့သည် အချက်အလက် ခွဲခြမ်းစိတ်ဖြာမှု ကွတ်ကီးများကို အသုံးပြုပါသည်။ ၎င်းတို့ကို သင်လက်ခံမှသာ ထည့်သွင်းမည်ဖြစ်သည်။ ကuki မူဝါဒ

သင့်ကိုယ်ပိုင်စနစ်များမှ Zinn® ဟို့စ်တင်းကို ရောင်းချခြင်း