Prodaja Zinn® hostinga sa sopstvenih sistema

Vi preprodajete naš hosting. Vaši klijenti su samo vaši: vaše cene, vaši računi, vaš procesor plaćanja. Ovako upravljate našom platformom iz bilo čega što već koristite — panela za naplatu, vašeg WordPress sajta ili skripte.

Šta vaši klijenti zapravo vide

Pre same mehanike: vaši klijenti nikada ne moraju da vide nas. Postoje tri površine, a vi birate koju ćete koristiti.

| Površina | Čija je | |---|---| | Hosting panel, na vašem nazivu hosta | Podesite naziv hosta za panel u okviru Preprodaja → Vaš brend i vaši klijenti se prijavljuju na panel.yourcompany.com uz vaš logo i vaše boje. Isti panel, vaša adresa. | | Vaš sopstveni veb-sajt | WordPress dodatak postavlja pretragu domena i vezu za prijavu jednim klikom na vaš sajt, a porudžbinu obrađuje kroz vašu WooCommerce kasu. | | Vaš panel za naplatu | WHMCS ili HostBill ostaju ulazna vrata; modul vrši proviziju u pozadini, a dugme u korisničkoj zoni ih prijavljuje direktno u njihov hosting. |

⛔ Koju god opciju da izaberete, vi ste zvanični trgovac (merchant of record) za vaše klijente: vaše cene, vaši računi, vaš PIB/PIB broj, vaš procesor plaćanja. Mi fakturišemo vama, jednom mesečno, po veleprodajnim cenama.

Kada podesite naziv hosta za panel, unesite ga u polje Adresa panela u WordPress dodatku i nigde više — veze za prijavu koje ovaj API generiše automatski ga prate.

Četiri načina za pristup

Postoje četiri načina za pristup, a svi u pozadini rade istu stvar:

| | Za | |---|---| | WHMCS modul | WHMCS prodavnicu | | HostBill modul | HostBill prodavnicu | | WordPress dodatak | Prodaju sa vašeg WordPress ili WooCommerce sajta | | API | Sve ostalo — Blesta, interni sistem, cron skriptu |

1. Preuzmite API ključ

U svojoj komandnoj tabli idite na API ključevi i kreirajte jedan. Dodelite mu samo ono što mu je potrebno:

| Dozvola | Zašto | |---|---| | org.read | Čitanje naloga vaših klijenata | | sites.create | Provizija sajta | | sites.view | Čitanje usluge | | sites.delete | Gašenje usluge | | reseller.view | Prikaz vaših usluga i čitanje potrošnje | | reseller.provision | Suspenzija, aktivacija i prijava klijenta |

⛔ Ne dodeljujte integraciji dozvolu reseller.manage. Ta dozvola uređuje vaša cenovnike i podatke o vašim pristupnicima za plaćanje. Dozvola reseller.provision postoji upravo zato da ključ koji nalepite u panel za naplatu ili veb-sajt ne bi morao da je ima.

Ključ se prikazuje samo jednom. Sačuvajte ga tamo gde čuvate ostale pristupne podatke — nikada u datoteci koju vaš veb-server javno poslužuje.

2. Napravite prvi poziv

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

To vraća svaku uslugu koju ste provizionisali, po jedan red po sajtu, sa klijentom kome pripada, njenim statusom i iznosom koji joj naplaćujete. Na novom nalogu to je prazna lista — što je tačan odgovor, a ne greška.

3. Cela integracija, u šest poziva

KADA                 POZIV
je porudžbina plaćena POST   /v1/orgs                                   jednom po KLIJENTU
                     POST   /v1/sites                                  jednom po USLUZI
nisu platili         POST   /v1/reseller/services/{siteId}/suspend
platili su           POST   /v1/reseller/services/{siteId}/unsuspend
otkažu               DELETE /v1/sites/{siteId}
"prijava na hosting" POST   /v1/reseller/services/{siteId}/sso

Provizija se sastoji od dva poziva, a ključevi su od ključne važnosti:

# 1. nalog klijenta — vezan za VAŠ ID klijenta
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. njihov sajt — vezan za VAŠ ID usluge
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"}'

Dva pravila koja koštaju novca ako ih pogrešno primenite

Vežite nalog za vašeg KLIJENTA, a sajt za vašu USLUGU. Druga porudžbina klijenta mora završiti na nalogu koji već poseduje. Ako oba vežete za uslugu, jedan klijent će završiti sa tri nepovezana naloga i tri odvojena panela.
Pošaljite Idempotency-Key uz svaki POST, kreiran iz vašeg sopstvenog ID-ja za tu stavku. Svaki sistem za naplatu ponavlja zahteve — povratni poziv sa mrežnog prolaza stigne dva puta, administrator ponovo pokrene neuspelu proviziju, klijent klikne dvaput. Bez ovog ključa, drugi pokušaj kreira drugi sajt i to će vam biti naplaćeno.

Tri odgovora koja ne smete sažeti u dva

unsuspend može vratiti 409. To znači da naš tim za zloupotrebe drži sajt pod suspenzijom, a ne vi. Prikažite poruku; ne pokušavajte ponovo.
**Gašenje usluge zakazuje brisanje, ne izvršava ga odmah.** Datum se vraća kao pending_deletion_at. Reći klijentu da su njegovi podaci već obrisani kada to nisu, gore je nego ne reći mu ništa.
disk_used_bytes može biti null, a null nije nula. To znači da nismo mogli da izmerimo, a ne da ništa nije iskorišćeno. Preskočite to — ne upisujte 0 u sopstvenu evidenciju, jer ćete u suprotnom klijentu prikazati zelenu traku iskorišćenosti za sajt sa koga nemate očitavanje.

4. Prijavite klijenta

POST /v1/reseller/services/{siteId}/sso vraća URL za jednokratnu upotrebu koji klijenta vodi direktno na njegov nalog, već prijavljenog.

⛔ Generišite ga tek kada kliknu, nikada kada renderujete stranicu. Veza je za jednokratnu upotrebu i ističe za nekoliko minuta, tako da se veza upisana na stranicu potroši pri prvom pregledu stranice i ostaje u svakom kesu između vas i pregledača.

5. Umesto toga instalirajte modul

WHMCS — kopirajte modul u modules/servers/zinn/, dodajte server čija je Lozinka vaš API ključ i podesite liniju proizvoda na proizvodu. Pritisnite Testiraj vezu: izvršiće stvarni poziv i reći vam šta je platforma odgovorila.
HostBill — kopirajte u includes/modules/Hosting/zinn/ i povežite ga na isti način.
WordPress — Zinn® Reseller Toolkit: pretraga domena, veza za prijavu na hosting vaših klijenata i WooCommerce provizionisanje kada je porudžbina plaćena. Otvorenog koda na <https://github.com/Zinn-Digital/zinn-reseller-toolkit>, ili ga preuzmite iz sekcije Dodaci u vašoj komandnoj tabli.

6. Pokrenite uživo

Proverite ovo pre nego što primite prvu stvarnu porudžbinu:

Test veze prolazi na modulu, ili vaš prvi curl vraća listu.
Vaš cenovnik je podešen (Preprodaja → Vaše cene).
Vaš mrežni prolaz za plaćanje je povezan (Preprodaja → Mrežni prolazi za plaćanje) — vaši klijenti plaćaju vama, preko vašeg naloga.
Podaci o vašoj kompaniji su uneti (Preprodaja → Vaša kompanija) tako da računi vaših klijenata nose vaše pravno lice i PIB, a ne naše.
Napravili ste jednu stvarnu porudžbinu od početka do kraja i videli da se sajt pojavio.

Gde se nalazi sve ostalo

Kompletna API referenca — svaka krajnja tačka, generisana iz naše specifikacije, sa dozvolom koja je svakoj potrebna — nalazi se na <https://zinndigital.com/developers/api>.