WHMCS üzerinden Zinn® barındırma hizmeti satın

Zinn Digital® modülü, WHMCS'nin kendi düğmelerini platformumuzda gerçek eylemlere dönüştürür. Bir sipariş, müşterinizin barındırma hizmetini sağlar. WHMCS'nin geciken fatura otomasyonu bunu askıya alır. Faturanın ödendi olarak işaretlenmesi hizmeti serbest bırakır. İptal etme, silme işlemini zamanlar. Ve müşteriniz, müşteri alanında doğrudan oturum açmalarını sağlayan bir Barındırma paneline giriş yap düğmesine sahip olur.

Ücretsizdir, GPL-2.0-or-later lisansına sahiptir ve platformumuza ayrıcalıklı bir yolu yoktur: yaptığı her çağrı, kendi API anahtarınızla kendinizin yapabileceği belgelenmiş bir uç noktadır.

Başlamadan önce

İki şeye ihtiyacınız vardır ve ikincisi genellikle insanları yanıltır.

1. Aktif bir programa sahip bir Zinn® bayi hesabı. zinndigital.com adresinden kaydolun ve bayiliği etkinleştirin.
2. Site kotası olan bir bayi planı. Müşterilerinizin sipariş ettiği siteler sizin planınızdan düşer, bu nedenle içinde boş yer olan bir plana ihtiyacınız vardır.

⚠️ Bağlantıyı Test Et, bir siparişin başarılı olup olmayacağını size söyleyemez. Programınızı okur ve hiçbir şey sağlamaz, bu nedenle henüz hiçbir şey satamayan sağlıklı bir active (aktif) hesabı bildirir. İlk siparişiniz "Bu organizasyonun barındırma planı yok, bu nedenle henüz site barındıramaz" hatasıyla başarısız olursa, durum budur; bayi planınızı satın alın veya uzatın ve siparişi tekrar verin. Modülde yanlış olan hiçbir şey yoktur.

1. API anahtarını oluşturun

Zinn® kontrol panelinizde API keys (API anahtarları) bölümünü açın ve tam olarak şu on bir izne sahip bir anahtar oluşturun:

| İzin | Neden gerekli | | -------------------- | ----------------------------------------------------------- | | org.create | İlk siparişlerinde müşterinizin Zinn® hesabını açmak için. | | org.read | Müşteri hesaplarınızı okumak için. | | sites.create | Siteyi sağlamak için. | | sites.view | Bir hizmeti ve kullanımını okumak için. | | sites.delete | Sonlandırmak için. | | reseller.view | Sattıklarınızı listelemek ve disk ile bant genişliğini okumak için. | | reseller.provision | Askıya almak, serbest bırakmak, bir müşterinin oturum açmasını sağlamak, planını ayarlamak ve paketini değiştirmek için. | | billing.view | Yükseltmenin ne kadara mal olacağını gerçekleştirmeden önce okumak için. | | sites.manage | Düğmelerden önbelleği temizlemek ve yedek almak için. | | sites.panel_access | WordPress yönetici şifresini değiştirmek için. | | hosting.php.manage | Yükseltme veya düşürmede PHP sürümünü değiştirmek için. |

⛔ reseller.manage iznini vermeyin. Bir faturalandırma paneline yapıştırılan bir anahtar, ödeme yapılmadığı için bir müşteriyi askıya alabilmeli ve oturum açtırabilmelidir. Kendi ödeme geçidi kimlik bilgilerinizi okuyabilmeli ve yeniden yazabilmelidir. reseller.provision, daha büyük olan izni vermek zorunda kalmamanız için mevcuttur. ⛔ org.create isteğe bağlı değildir. Bu izin olmadan modül hesaplarınızı okuyabilir ancak yeni bir hesap açamaz, bu nedenle Bağlantı Testi başarılı olur ve ilk sipariş 403 hatası döndürür. ⛔⛔ Tablonun tamamına izin verin ve Bağlantı Testinin eksik izniniz olup olmadığını söyleyemeyeceğini unutmayın. Bayi programınızı okur ve hiçbir şey sağlamaz, bu nedenle bu izinlerden herhangi birine sahip olmayan bir anahtar için bile yeşil renktedir. Bunun yerine aylar sonra bir müşteriden, eksik iznin kapsadığı tek işlem üzerinde bir 403 hatası alırsınız.

2. Modülü yükleyin

1. Modülü indirin ve arşivden çıkarın.
2. Modül dosyasının modules/servers/zinn/zinn.php konumuna yerleşmesi için zinn dizinini WHMCS kurulumunuza yükleyin.

⛔ Dizin adı zinn olmalıdır. WHMCS, bir sağlama modülünün işlev adlarını dizin adından türetir, bu nedenle adı zinn-whmcs veya zinndigital olarak değiştirmek, WHMCS'nin listelediği, seçmenize izin verdiği ve ardından hiçbir hata vermeden asla çağrılmadığı bir modül oluşturur. Zip dosyası zaten doğru adla çıkar; sadece adını değiştirmeyin.

3. Sunucuyu ekleyin

WHMCS'de: Configuration → System Settings → Servers → Add New Server.

• Name (Ad): herhangi bir şey, örn. Zinn Digital®
• Hostname (Ana Bilgisayar Adı): api.zinndigital.com
• Type (Tür): Zinn Digital®
• Password (Şifre): 1. adımdaki API anahtarınız

⛔ Anahtar, WHMCS'nin şifrelenmiş olarak sakladığı Password (Şifre) alanına girilir. Bunu bir ürün yapılandırma seçeneğine koymayın; bunlar veritabanında düz metin olarak yer alır ve her yönetici tarafından görülebilir; bu kimlik bilgisi ise müşterilerinizin barındırma hizmetini oluşturabilir ve yok edebilir.

Test Connection (Bağlantıyı Test Et) düğmesine basın. Alanların dolu olup olmadığını kontrol etmek yerine, gerçek bir çağrı yapar ve platformumuzun ne yanıt verdiğini bildirir.

4. Ürünü oluşturun

Configuration → System Settings → Products/Services bölümüne gidin ve ardından Module Settings (Modül Ayarları) kısmını az önce eklediğiniz sunucu olarak ayarlayın. Alanlar şunlardır:

| Alan | Zorunlu | Ne olduğu | | ---------------- | -------- | -------------------------------------------------------------------------- | | Product line | evet | Sattığınız Zinn® hattı — mainstream (yönetilen WordPress), footprint_free, wordpress, linux, cloud, agency, app_hosting, ai_hosting, lms_hosting, managed_database, vector_hosting, zinn_compute, fleet_linux, fleet_enterprise, mail veya reseller. | | Stack | evet | Ne oluşturulacağı: wordpress (varsayılan), woocommerce, php, static, node, one_click, headless_cms, nextcloud veya owncloud. | | Application | hayır | Yalnızca one_click ve headless_cms yığınları için — hangi uygulamanın yükleneceği. Başka bir yığında bir ad belirtmek reddedilir, çünkü o yığın neyin yükleneceğine zaten karar verir. | | PHP version | hayır | örn. 8.3. Hattın varsayılanı için boş bırakın. Hattın sunmadığı bir sürüm, sunduğu sürümlerin listesiyle birlikte reddedilir. | | Plan code | evet | Bu ürünün sattığı Zinn® planı. GET /v1/reseller/prices komutu sizinkileri listeler. Plan kodu olmayan bir sipariş reddedilir — aşağıdaki uyarıya bakın. | | Billing interval | hayır | monthly (varsayılan) veya annual — bu müşteri için toptan satış hattınızın faturalandırıldığı aralık. Kendi müşterinize ne kadar ücret yansıtacağınız WHMCS ürününden ayarlanır ve bundan etkilenmez. |

⛔⛔ Plan kodu zorunludur ve plan kodu olmayan bir sipariş bilerek reddedilir. 2026-09-01 tarihine kadar bu alan dekoratifti ve hiçbir şey bunu okumuyordu, bu nedenle modül hiçbir plan içermeyen barındırma hizmeti sipariş ediyordu ve bunun her sonucu sessizce gerçekleşiyordu. Toptan satış ekstreniz müşterilerinizin aktif aboneliklerinden oluşturulur, bu nedenle hizmet için hiçbir satır yoktu ve çalıştığı sürece size hiçbir fatura kesilmedi; müşteriniz hiçbir kotayı devralmadı, bu nedenle sitesine hiçbir disk veya dosya kotası uygulanmadı; ve Change Package (Paket Değiştir) değiştirilecek hiçbir şeye sahip değildi, bu nedenle sattığınız bir yükseltme gerçekleştirilemedi. Site, süreç boyunca kusursuz bir şekilde sağlandı ve hizmet verdi.

Modül artık bunun yerine siparişi reddeder, çünkü tahmin edebileceği güvenli bir plan yoktur: bir tahmin, seçmediğiniz ve fiyatlandırmamış olabileceğiniz bir planda barındırma hizmeti sağlardı ve — hemen okuduğunuz bir reddetme işleminin aksine — bu durum ancak bir ekstre geldiğinde, o da gelirse ortaya çıkardı.

Auto Setup (Otomatik Kurulum) seçeneğini tercih ettiğiniz şekilde ayarlayın; modül, WHMCS hizmet kimliği üzerinden eşlemelidir (idempotent), bu nedenle yeniden denenen bir sağlama işlemi, ikincisi için sizden ücret almak yerine aynı siteyi döndürür.

Her WHMCS eyleminin yaptığı şeyler

| WHMCS eylemi | Tarafımızda ne olur | | --------------------------- | ---------------------------------------------------------------------------------------- | | Create | Müşterinin Zinn® hesabını oluşturur (veya halihazırda sahip olduklarını yeniden kullanır) ve sitesini sağlar. | | Suspend | Siteyi ödeme yapılmadığı için askıya alır. İçerik saklanır; hiçbir şey silinmez. | | Unsuspend | Sizin koyduğunuz askıyı kaldırır. | | Terminate | Bir yetkisizlik süresiyle birlikte sitenin silinmesini zamanlar. Tarih müşteri alanında görünür. | | Usage update | Her hizmetteki disk ve bant genişliğini günde bir kez yeniler. | | Log in to hosting panel | Doğrudan müşterinizin paneline açılan bir defalık, tek kullanımlık bir oturum açma bağlantısı açar. | | Change Package | Hizmeti yükseltir veya düşürür. Paketi ve yeni ürün bir sürüm belirtiyorsa PHP sürümünü taşır. | | Change Password | WordPress yöneticisinin şifresini ayarlar. Bu kutu, böyle bir hesabı olmayan yığınlarda görünmez. | | Renew | Hizmetin hala var olduğunu doğrular. Zinn® barındırma süreklidir, bu nedenle uzatılacak uzak bir vadeli işlem yoktur. | | Sync Usage / Purge Cache / Take Backup | Yönetici hizmet sayfasındaki düğmeler. Müşteriniz müşteri alanında Purge Cache (Önbelleği Temizle) ve Take Backup (Yedek Al) seçeneklerine sahip olur. | | Service tab | Durum, plan, disk, bant genişliği, zamanlanmış silme işlemleri ve askıya alma işlemini kimin gerçekleştirdiği. | | Import | ListAccounts her sayfayı okur, böylece bir içe aktarım işlemi ilk sayfada sessizce duramaz. |

Yükseltmeler: kim kime fatura keser

Müşterinize bir siparişte veya yükseltmede asla Zinn® tarafından fatura kesilmez. Onlara WHMCS üzerinden fatura kesersiniz; biz ise size toptan satış ekstreniz üzerinden fatura keseriz. Dolayısıyla, bir Change Package (Paket Değiştir) işlemi müşterinizin haklarını ve sonraki ekstrenizdeki kalemi taşır, ancak hiçbir karta dokunmaz — WHMCS müşterinizin parasını çoktan almış ve kendi orantılamasını hesaplamıştır.

Bir müşterinin ikinci hizmeti. Aynı planda, o planın kendi site kotası altında başka bir sitedir ve başka bir şey verilmez. Farklı bir planda ise reddedilir: canlı planın değiştirilmesi, iki hizmetten birinin faturalandırılmamış kalmasına neden olur. Her iki hizmeti de aynı planda kesin veya müşteriyi WHMCS'de ayrı bir müşteri kaydı olarak ayarlayın.

Change Password yalnızca WordPress için vardır. Zinn® barındırmanın tek bir "hizmet şifresi" yoktur — müşteriniz paneline oturum açma düğmesiyle ulaşır — ve bir php veya static sitesinin değiştirilecek uygulama hesabı yoktur. WHMCS, çalışamayacak bir kutu göstermek yerine kutuyu tamamen gizler.

İkiye indirgememeniz gereken üç yanıt

• Unsuspend bir reddetme ile yanıt verebilir. Bu, sitenin sizin tarafınızdan değil, kötüye kullanım (abuse) ekibimiz tarafından askıya alındığını ve hiçbir faturalandırma panelinin bunu serbest bırakamayacağını gösterir. Mesaj bunu belirtir; yeniden denemek yerine bunu yöneticinize gösterin.
• Terminate bir silme işlemini zamanlar, gerçekleştirmez. Tarih pending_deletion_at olarak geri döner ve müşteri alanı bunu gösterir. Bir müşteriye verilerinin henüz gitmemişken gitmiş olduğunu söylemek, onlara hiçbir şey söylememekten daha kötüdür.
• Disk ve bant genişliği bilinmiyor olabilir ve bilinmiyor olmak sıfır demek değildir. Okuma yapamadığımız durumlarda modül, 0 yazmak yerine rakamı olduğu gibi bırakır — aksi takdirde WHMCS, okuma yapamadığımız bir site için müşterinize güven verici boş bir kullanım çubuğu gösterirdi.

Sorun giderme

Bağlantı Testi başarılı oluyor ve ilk sipariş bir izin hatasıyla başarısız oluyor. API anahtarında org.create izni eksik. Modül, müşterinin sitesini oluşturabilmeden önce hesabını açmalıdır.

Bir sipariş, organizasyonun barındırma planı olmadığını belirterek başarısız oluyor. Bayi planınızda hiç site kotası kalmamış veya henüz bir plana sahip değilsiniz. Yukarıdaki Başlamadan önce bölümüne bakın.

Bir sipariş, bir yığında bahsedilerek başarısız oluyor. Üründeki Stack (Yığın) alanı boş veya oluşturmadığımız bir şeyi adlandırıyor. Başka bir şey satmıyorsanız bunu wordpress olarak ayarlayın.

İptal etme işlemleri başarısız oluyor. Modül sürümünün 1.0.0 veya üzerinde olduğundan emin olun. Daha eski sürümler silme onayı göndermedi ve her sonlandırma işlemi reddedildi, bu da hizmetin çalışmaya ve faturalandırılmaya devam etmesine neden oldu.

Bir alanı belirten bir reddetme. Doğrulama hatalarımız, mesajdan sonra parantez içinde alanı ve nedeni belirtir, örn. (php_version: 7.2 is not offered on this product line). İşlemi yapılabilir olan kısım budur — önündeki cümle bilerek genel tutulmuştur.

İndirmenizi doğrulayın

Her arşiv, kendi ana bilgisayar adımız üzerinden TLS ile sunulur ve asla üçüncü taraf bir barındırıcıya yönlendirilmez. SHA-256 sağlama toplamı, downloads page (indirme sayfasında) indirme bağlantısının yanında yazdırılır. İndirdikten sonra karşılaştırın:

• macOS veya Linux: shasum -a 256 zinn-whmcs-1.0.0.zip
• Windows: certutil -hashfile zinn-whmcs-1.0.0.zip SHA256

WHMCS kullanmıyor musunuz?

Diğer her şey için bir HostBill modülü ve tek dosyalık bir PHP istemcisi mevcuttur; her ikisi de ücretsizdir ve aynı downloads page (indirme sayfasında) bulunmaktadır. Modüllerin kullandığı her uç nokta API reference (API referansında) yer almaktadır.