మీ స్వంత సిస్టమ్‌ల నుండి Zinn® హోస్టింగ్‌ను విక్రయించడం

మీరు మా హోస్టింగ్‌ను రీసెల్ చేస్తారు. మీ క్లయింట్లు మీ స్వంతం: మీ ధరలు, మీ ఇన్‌వాయిస్‌లు, మీ పేమెంట్ ప్రొవైడర్. మీరు ఇప్పటికే రన్ చేస్తున్న దేని నుండైనా — బిల్లింగ్ ప్యానెల్, మీ స్వంత WordPress సైట్, లేదా స్క్రిప్ట్ నుండి మా ప్లాట్‌ఫారమ్‌ను ఎలా నడపాలో ఇది వివరిస్తుంది.

మీ క్లయింట్‌లకు వాస్తవంగా కనిపించేది

సాంకేతిక వివరాలకు వెళ్ళే ముందు: మీ క్లయింట్‌లకు మేము ఎప్పటికీ కనిపించాల్సిన అవసరం లేదు. మూడు ఇంటర్‌ఫేస్‌లు ఉన్నాయి, మీరు దేనిని ఉపయోగించాలో మీరే ఎంచుకోవచ్చు.

⛔ మీరు దేనిని ఎంచుకున్నా, మీ క్లయింట్‌ల కోసం మీరే మర్చంట్ ఆఫ్ రికార్డ్: మీ ధరలు, మీ ఇన్‌వాయిస్‌లు, మీ VAT నంబర్, మీ పేమెంట్ ప్రొవైడర్. మేము మీకు, నెలకు ఒకసారి, హోల్‌సేల్ ధరకు బిల్ చేస్తాము.

మీరు ప్యానెల్ హోస్ట్‌నేమ్‌ను సెట్ చేసిన తర్వాత, దానిని WordPress ప్లగిన్‌లోని Panel address ఫీల్డ్‌లో మాత్రమే నమోదు చేయండి, మరెక్కడా వద్దు — ఈ API రూపొందించే సైన్-ఇన్ లింక్‌లు దానిని ఆటోమేటిక్‌గా అనుసరిస్తాయి.

లోపలికి వెళ్ళడానికి నాలుగు మార్గాలు

లోపలికి వెళ్ళడానికి నాలుగు మార్గాలు ఉన్నాయి, అవన్నీ తెరవెనుక ఒకే పనిని చేస్తాయి:

1. ఒక API కీని పొందండి

మీ డ్యాష్‌బోర్డ్‌లో, API keys కు వెళ్లి ఒకదాన్ని సృష్టించండి. దానికి అవసరమైన వాటిని మాత్రమే ఇవ్వండి:

⛔ ఇంటిగ్రేషన్‌కు reseller.manage అనుమతిని ఇవ్వవద్దు. ఆ అనుమతి మీ ధరల జాబితాను మరియు మీ స్వంత పేమెంట్-గేట్‌వే ఆధారాలను సవరిస్తుంది. బిల్లింగ్ ప్యానెల్ లేదా వెబ్‌సైట్‌లో మీరు పేస్ట్ చేసే కీకి ఇది అవసరం లేకుండా ఉండేందుకే ప్రత్యేకంగా reseller.provision రూపొందించబడింది.

కీ ఒక్కసారి మాత్రమే చూపబడుతుంది. మీ ఇతర ఆధారాలను ఎక్కడ భద్రపరుస్తారో అక్కడే దీన్ని భద్రపరచండి — మీ వెబ్ సర్వర్ అందించే ఫైల్‌లో ఎప్పుడూ ఉంచవద్దు.

2. మీ మొదటి కాల్ చేయండి

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

ప్రొవిజనింగ్ అనేది రెండు కాల్స్ ప్రక్రియ, మరియు కీలు చాలా ముఖ్యమైనవి:

# 1. the customer's account — keyed on YOUR customer 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. their site — keyed on YOUR service 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 లో, ఆ నిర్దిష్ట అంశం కోసం మీ స్వంత ఐడీతో రూపొందించిన ఒక Idempotency-Keyని పంపండి. ప్రతి బిల్లింగ్ సిస్టమ్ మళ్లీ ప్రయత్నిస్తుంది — గేట్‌వే కాల్‌బ్యాక్ రెండుసార్లు వస్తుంది, అడ్మిన్ విఫలమైన ప్రొవిజన్‌ను మళ్లీ రన్ చేస్తారు, లేదా కస్టమర్ డబుల్-క్లిక్ చేస్తారు. కీ లేకపోతే రెండవ ప్రయత్నం రెండవ సైట్‌ను సృష్టిస్తుంది మరియు దానికి మీకే బిల్ చేయబడుతుంది.

మీరు రెండుగా కుదించకూడని మూడు సమాధానాలు

• unsuspend కాల్ 409 సమాధానాన్ని ఇవ్వవచ్చు. అంటే సైట్‌ను మీరు కాకుండా మా దుర్వినియోగ నిరోధక (abuse) బృందం నిలిపివేసిందని అర్థం. సందేశాన్ని చూపించండి; మళ్లీ ప్రయత్నించవద్దు.
• **టెర్మినేట్ చేయడం అనేది తొలగింపును షెడ్యూల్ చేస్తుంది, వెంటనే తొలగించదు.** ఆ తేదీ pending_deletion_at గా తిరిగి వస్తుంది. కస్టమర్ డేటా ఇంకా తొలగించబడనప్పుడు అది ఇప్పటికే పోయిందని చెప్పడం ఏమీ చెప్పకపోవడం కంటే దారుణం.
• disk_used_bytes అనేది null కావచ్చు, మరియు null అంటే సున్నా కాదు. మేము కొలవలేకపోయామని దాని అర్థం, ఏమీ ఉపయోగించలేదని కాదు. దానిని వదిలివేయండి — మీ స్వంత రికార్డులలో 0 అని రాయవద్దు, లేకపోతే మీరు రీడింగ్ లేని సైట్ కోసం కస్టమర్‌కు గ్రీన్ యూసేజ్ బార్‌ను చూపిస్తారు.

4. ఒక క్లయింట్‌ను సైన్ ఇన్ చేయండి

POST /v1/reseller/services/{siteId}/sso ఒకేసారి ఉపయోగించే URLను అందిస్తుంది, ఇది మీ క్లయింట్‌ను ఇప్పటికే సైన్ ఇన్ అయి ఉన్న వారి స్వంత ఖాతాలోకి నేరుగా తీసుకెళ్తుంది.

⛔ వారు క్లిక్ చేసినప్పుడు మాత్రమే దాన్ని రూపొందించండి, పేజీని రెండర్ చేసినప్పుడు ఎప్పుడూ చేయవద్దు. ఈ లింక్ ఒక్కసారి మాత్రమే ఉపయోగించగలదు మరియు కొద్ది నిమిషాల్లో గడువు ముగుస్తుంది, కాబట్టి పేజీలో వ్రాసిన లింక్ మొదటి పేజీ వీక్షణలోనే కాలిపోతుంది మరియు మీకు అలాగే బ్రౌజర్‌కు మధ్య ఉన్న ప్రతి కాష్‌లో మిగిలిపోతుంది.

5. బదులుగా ఒక మాడ్యూల్‌ను ఇన్‌స్టాల్ చేయండి

• WHMCS — మాడ్యూల్‌ను modules/servers/zinn/కి కాపీ చేయండి, మీ API కీ Passwordగా ఉండే ఒక సర్వర్‌ను జోడించండి మరియు ప్రోడక్ట్‌పై ప్రోడక్ట్ లైన్‌ను సెట్ చేయండి. Test Connection నొక్కండి: ఇది నిజమైన కాల్ చేసి ప్లాట్‌ఫారమ్ ఏమి చెప్పిందో మీకు తెలియజేస్తుంది.
• HostBill — includes/modules/Hosting/zinn/కి కాపీ చేసి, అదే విధంగా కనెక్ట్ చేయండి.
• WordPress — Zinn® Reseller Toolkit: డొమైన్ శోధన, మీ క్లయింట్‌ల హోస్టింగ్‌లోకి సైన్-ఇన్ లింక్, మరియు ఆర్డర్ చెల్లించినప్పుడు WooCommerce ప్రొవిజనింగ్. ఇది <https://github.com/Zinn-Digital/zinn-reseller-toolkit> వద్ద ఓపెన్ సోర్స్‌గా లభిస్తుంది, లేదా మీ డ్యాష్‌బోర్డ్‌లోని Plugins నుండి డౌన్‌లోడ్ చేసుకోండి.

6. లైవ్ వెళ్ళండి

మీరు అసలైన ఆర్డర్‌ను స్వీకరించే ముందు వీటిని తనిఖీ చేయండి:

• మాడ్యూల్‌లో కనెక్షన్ పరీక్ష విజయవంతమైంది, లేదా మీ మొదటి curl ఒక జాబితాను తిరిగి ఇస్తుంది.
• మీ ధరల జాబితా సెట్ చేయబడింది (Reselling → Your prices).
• మీ పేమెంట్ గేట్‌వే కనెక్ట్ చేయబడింది (Reselling → Payment gateways) — మీ క్లయింట్లు మీ స్వంత ఖాతా ద్వారా మీకు చెల్లిస్తారు.
• మీ కంపెనీ వివరాలు నమోదు చేయబడ్డాయి (Reselling → Your company), కాబట్టి మీ క్లయింట్ ఇన్‌వాయిస్‌లలో మా వివరాలు కాకుండా మీ చట్టబద్ధమైన సంస్థ మరియు VAT నంబర్ ఉంటాయి.
• మీరు ప్రారంభం నుండి ముగింపు వరకు ఒక నిజమైన ఆర్డర్‌ను పూర్తి చేసి, సైట్ కనిపించడాన్ని గమనించారు.

మిగిలిన వివరాలన్నీ ఎక్కడ ఉన్నాయి

పూర్తి API రిఫరెన్స్ — ప్రతి ఎండ్‌పాయింట్, మా స్పెసిఫికేషన్ నుండి రూపొందించబడినది, ప్రతిదానికి అవసరమైన అనుమతులతో సహా — <https://zinndigital.com/developers/api> వద్ద అందుబాటులో ఉంది.