તમારી પોતાની સિસ્ટમ્સમાંથી Zinn® હોસ્ટિંગનું વેચાણ કરવું

તમે અમારા હોસ્ટિંગનું પુનર્વેચાણ (resell) કરો છો. તમારા ગ્રાહકો તમારા પોતાના છે: તમારા ભાવો, તમારા ઇનવૉઇસેસ, તમારા ચુકવણી પ્રદાતા. તમે હાલમાં જે પણ ચલાવી રહ્યા હોવ — બિલિંગ પેનલ, તમારી પોતાની WordPress સાઇટ, અથવા કોઈ સ્ક્રિપ્ટ — ત્યાંથી અમારા પ્લેટફોર્મનું સંચાલન આ રીતે કરી શકો છો.

તમારા ગ્રાહકો વાસ્તવમાં શું જુએ છે

કાર્યપદ્ધતિ સમજીએ તે પહેલાં: તમારા ગ્રાહકોએ અમને ક્યારેય જોવાની જરૂર પડતી નથી. ત્રણ માધ્યમો છે, અને તમે કયું વાપરવું તે પસંદ કરી શકો છો.

⛔ તમે ગમે તે પસંદ કરો, તમે તમારા ગ્રાહકો માટે રેકોર્ડના વેપારી (merchant of record) છો: તમારા ભાવો, તમારા ઇનવૉઇસેસ, તમારો 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 આપી શકે છે. તેનો અર્થ એ છે કે સાઇટને અમારી અબ્યુઝ ટીમે રોકી રાખી છે, તમે નહીં. સંદેશ દર્શાવો; ફરી પ્રયાસ કરશો નહીં.
• સમાપ્ત (Terminating) કરવું એ ડિલીશન શેડ્યૂલ કરે છે, તરત જ ડિલીટ કરતું નથી. તારીખ pending_deletion_at તરીકે પાછી આવે છે. ગ્રાહકને તેનો ડેટા પહેલેથી જ નીકળી ગયો છે તેમ કહેવું, જ્યારે તે વાસ્તવમાં ન ગયો હોય, તે કંઈ ન કહેવા કરતાં પણ વધુ ખરાબ છે.
• disk_used_bytes નું મૂલ્ય null હોઈ શકે છે, અને null એટલે શૂન્ય નથી. તેનો અર્થ એ છે કે અમે માપી શક્યા નથી, એવો નહીં કે કશું વપરાયું નથી. તેને અવગણો — તમારા પોતાના રેકોર્ડ્સમાં 0 લખશો નહીં, અન્યથા તમે જે સાઇટનું કોઈ રીડિંગ નથી તેના માટે ગ્રાહકને લીલો વપરાશ બાર બતાવશો.

4. ક્લાયન્ટને સાઇન ઇન કરાવો

POST /v1/reseller/services/{siteId}/sso એક સિંગલ-યુઝ URL પરત કરે છે જે તમારા ક્લાયન્ટને સીધા તેમના પોતાના એકાઉન્ટમાં, પહેલેથી સાઇન ઇન કરેલ સ્થિતિમાં લઈ જાય છે.

⛔ તેઓ ક્લિક કરે ત્યારે જ તેને જનરેટ કરો, પેજ રેન્ડર કરતી વખતે ક્યારેય નહીં. આ લિંક સિંગલ-યુઝ છે અને થોડીવારમાં એક્સપાયર થઈ જાય છે, તેથી પેજમાં લખેલી લિંક પ્રથમ પેજ વ્યૂ પર જ નકામી થઈ જાય છે અને તમારા અને બ્રાઉઝર વચ્ચેના દરેક કેશમાં રહી જાય છે.

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> પર ઓપન સોર્સ ઉપલબ્ધ છે, અથવા તમારા ડેશબોર્ડમાં Plugins માંથી તેને ડાઉનલોડ કરો.

6. લાઇવ થાઓ

વાસ્તવિક ઓર્ડર લેતા પહેલાં આ તપાસી લો:

• મોડ્યુલ પર કનેક્શન ટેસ્ટ પાસ થાય છે, અથવા તમારો પ્રથમ curl એક સૂચિ પરત કરે છે.
• તમારી ભાવસૂચિ સેટ કરેલી છે (Reselling → Your prices).
• તમારું પેમેન્ટ ગેટવે કનેક્ટેડ છે (Reselling → Payment gateways) — તમારા ક્લાયન્ટ્સ તમારા પોતાના એકાઉન્ટ દ્વારા તમને ચૂકવણી કરે છે.
• તમારી કંપનીની વિગતો દાખલ કરેલી છે (Reselling → Your company) જેથી તમારા ક્લાયન્ટ ઇનવૉઇસેસ પર તમારી કાનૂની એન્ટિટી અને VAT નંબર હોય, અમારો નહીં.
• તમે શરૂઆતથી અંત સુધી એક વાસ્તવિક ઓર્ડર આપ્યો છે અને સાઇટ દેખાતી જોઈ છે.

બીજું બધું ક્યાં છે

સંપૂર્ણ API સંદર્ભ — દરેક એન્ડપોઇન્ટ, અમારા સ્પેસિફિકેશનમાંથી જનરેટ કરેલ, દરેક માટે જરૂરી પરવાનગી સાથે — <https://zinndigital.com/developers/api> પર ઉપલબ્ધ છે.