Prodaja Zinn® hostinga s vaših vlastitih sustava

Preprodajete naš hosting. Vaši klijenti pripadaju vama: vaše cijene, vaši računi, vaš pružatelj platnih usluga. Ovako upravljate našom platformom iz bilo čega što već koristite — sustava za naplatu, vlastite WordPress stranice ili skripte.

Što vaši klijenti zapravo vide

Prije same mehanike: vaši klijenti nas nikada ne moraju vidjeti. Postoje tri sučelja, a vi birate koje ćete koristiti.

| Sučelje | Čije je | |---|---| | Hosting panel, na vašem nazivu poslužitelja | Postavite naziv poslužitelja za panel pod Preprodaja → Vaš brend i vaši se klijenti prijavljuju na panel.vašatvrtka.com s vašim logotipom i vašim bojama. Isti panel, vaša adresa. | | Vaša vlastita web-stranica | WordPress priključak stavlja pretragu domena i poveznicu za prijavu jednim klikom na vašu stranicu te preuzima narudžbu putem vaše WooCommerce blagajne. | | Vaš sustav za naplatu | WHMCS ili HostBill ostaju ulazna vrata; modul obavlja pripremu u pozadini, a gumb u korisničkom sučelju prijavljuje ih izravno u njihov hosting. |

⛔ Koji god odabrali, vi ste službeni trgovac za svoje klijente: vaše cijene, vaši računi, vaš PDV ID broj, vaš pružatelj platnih usluga. Mi naplaćujemo vama, jednom mjesečno, po veleprodajnoj cijeni.

Kada postavite naziv poslužitelja za panel, unesite ga u polje Adresa panela u WordPress priključku i nigdje drugdje — poveznice za prijavu koje ovaj API generira automatski ga prate.

Četiri načina ulaza

Postoje četiri načina ulaza i svi u pozadini rade istu stvar:

| | Za | |---|---| | WHMCS modul | WHMCS trgovinu | | HostBill modul | HostBill trgovinu | | WordPress priključak | Prodaju s vaše vlastite WordPress ili WooCommerce stranice | | API | Sve ostalo — Blesta, interni sustav, cron skripta |

1. Dohvatite API ključ

U svojoj upravljačkoj ploči idite na API ključevi i izradite jedan. Dajte mu samo ono što mu je potrebno:

| Dozvola | Zašto | |---|---| | org.read | Čitanje računa vaših klijenata | | sites.create | Priprema stranice | | sites.view | Čitanje usluge | | sites.delete | Prekid usluge | | reseller.view | Popis vaših usluga i čitanje potrošnje | | reseller.provision | Suspenzija, aktivacija i prijava klijenta |

⛔ Nemojte integraciji dati reseller.manage. Ta dozvola uređuje vaš cjenik i vaše vlastite vjerodajnice za platni prolaz. reseller.provision postoji upravo zato da ključ koji zalijepite u sustav za naplatu ili na web-stranicu ne treba tu dozvolu.

Ključ se prikazuje samo jednom. Pohranite ga tamo gdje čuvate ostale vjerodajnice — nikada u datoteku koju poslužuje vaš web-poslužitelj.

2. Napravite svoj prvi poziv

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

To vraća svaku uslugu koju ste pripremili, jedan redak po stranici, s klijentom kojem pripada, njezinim statusom i iznosom koji joj naplaćujete. Na novom računu to je prazan popis — što je točan odgovor, a ne pogreška.

3. Cijela integracija, u šest poziva

KADA                 POZIV
je narudžba plaćena  POST   /v1/orgs                                   jednom po KUPCU
                     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 u hosting"  POST   /v1/reseller/services/{siteId}/sso

Priprema se sastoji od dva poziva, a ključevi su važni:

# 1. račun kupca — vezan uz VAŠ ID kupca
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. njihova stranica — vezana uz 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 primijenite

Vežite račun uz svog KUPCA, a stranicu uz svoju USLUGU. Druga narudžba kupca mora završiti na računu koji već ima. Ako oboje vežete uz uslugu, jedan kupac završava s tri nepovezana računa i tri odvojena panela.
Pošaljite Idempotency-Key uz svaki POST, izgrađen od vašeg vlastitog ID-ja za tu stavku. Svaki sustav za naplatu ponavlja pokušaje — povratni poziv platnog prolaza stigne dvaput, administrator ponovno pokrene neuspjelu pripremu, kupac dvaput klikne. Bez ključa, drugi pokušaj stvara drugu stranicu i ona vam se naplaćuje.

Tri odgovora koja ne smijete sažeti u dva

unsuspend može vratiti 409. To znači da naš tim za zlouporabe drži stranicu suspendiranom, a ne vi. Prikažite poruku; nemojte ponavljati pokušaj.
**Prekid usluge zakazuje brisanje, ne izvršava ga odmah.** Datum se vraća kao pending_deletion_at. Reći kupcu da su njegovi podaci već nestali kada nisu, gore je nego ne reći ništa.
disk_used_bytes može biti null, a null nije nula. To znači da nismo mogli izmjeriti, a ne da ništa nije potrošeno. Preskočite to — nemojte upisivati 0 u svoje zapise jer ćete u suprotnom kupcu prikazati zelenu traku zauzetosti za stranicu s koje nemate očitovanje.

4. Prijavite klijenta

POST /v1/reseller/services/{siteId}/sso vraća jednokratni URL koji vašeg klijenta vodi izravno na njegov račun, već prijavljenog.

⛔ Generirajte ga kada kliknu, nikada kada renderirate stranicu. Poveznica je jednokratna i tječe unutar nekoliko minuta, pa se poveznica zapisana na stranici potroši pri prvom prikazu stranice i ostane u svakom predspremniku između vas i preglednika.

5. Umjesto toga instalirajte modul

WHMCS — kopirajte modul u modules/servers/zinn/, dodajte poslužitelj čiji je Password vaš API ključ i postavite liniju proizvoda na proizvodu. Pritisnite Test Connection: to vrši stvarni poziv i govori vam što je platforma vratila.
HostBill — kopirajte u includes/modules/Hosting/zinn/ i povežite ga na isti način.
WordPress — Zinn® Reseller Toolkit: pretraga domena, poveznica za prijavu u hosting vaših klijenata i WooCommerce priprema kada je narudžba plaćena. Otvorenog koda na <https://github.com/Zinn-Digital/zinn-reseller-toolkit>, ili ga preuzmite iz odjeljka Priključci u svojoj upravljačkoj ploči.

6. Pokrenite u produkciji

Provjerite ovo prije nego što preuzmete stvarnu narudžbu:

Test povezivosti prolazi na modulu ili vaš prvi curl vraća popis.
Vaš cjenik je postavljen (Preprodaja → Vaše cijene).
Vaš platni prolaz je povezan (Preprodaja → Platni prolazi) — vaši klijenti plaćaju vama, preko vašeg računa.
Podaci o vašoj tvrtki su uneseni (Preprodaja → Vaša tvrtka) kako bi računi vaših klijenata sadržavali vaš pravni subjekt i PDV ID broj, a ne naš.
Napravili ste jednu stvarnu narudžbu od početka do kraja i vidjeli da se stranica pojavila.

Gdje se nalazi sve ostalo

Potpuna API referenca — svaka krajnja točka, generirana iz naše specifikacije, s dozvolom koja je svakoj potrebna — nalazi se na <https://zinndigital.com/developers/api>.