WHMCS 7.x / 8.x / 9.x WiseCP API anahtarı modüle gömülü gelir İndirme için bayi girişi gerekir
Başlamadan önce
Gereksinimler
Modüller, bayi hesabınızın API anahtarıyla SSL Sertifikası Reseller API'ye bağlanır. İndirdiğiniz ZIP dosyası hesabınıza özel üretilir.
WHMCS
WHMCS 7.x, 8.x veya 9.x
PHP 7.2 veya üzeri
cURL ve JSON PHP eklentileri
FTP/SFTP veya dosya yöneticisi erişimi
WiseCP
Güncel bir WiseCP kurulumu
PHP 7.4 veya üzeri
cURL ve JSON PHP eklentileri
FTP/SFTP veya panel erişimi
Bayi Hesabı
Aktif bayi hesabı ve açık API erişimi
Hesaba tanımlı bayi fiyat grubu
Siparişler için yeterli bakiye
Sunucunuzdan dışarıya HTTPS erişimi
Sunucu tanımı gerekmez. API adresi ve API anahtarınız modül dosyalarına gömülü gelir; WHMCS'te "Servers" bölümüne kayıt eklemeniz veya anahtar girmeniz gerekmez.
ZIP dosyasını paylaşmayın. İçinde API anahtarınız bulunur. Anahtarınızı bayi panelinden yenilerseniz modülü yeniden indirip dosyaları güncellemeniz gerekir.
Kurulum
Kurulum Adımları
Modülü indirin
Bayi hesabınıza giriş yapıp WHMCS modülünü indirin. Dosya adı datassl_whmcs_v5.11.0.zip biçimindedir.
Access Control bölümünden modülü kullanacak yönetici rollerini seçip kaydedin.
Etkinleştirme sırasında modül kendi tablolarını (mod_datassl_orders, mod_datassl_logs, mod_datassl_settings) ve 5 e-posta şablonunu (yapılandırma gerekli, sertifika düzenlendi, süre bitimi, yenilendi, yeniden düzenlendi) oluşturur.
Ürünleri oluşturun
Önerilen yol — Ürün Oluşturucu:
Addons → DATASSL SSL Certificates → Ürün Oluşturucu sayfasını açın.
Ürünlerin ekleneceği WHMCS ürün grubunu seçin (yoksa önce oluşturun).
Kâr marjı (markup) oranını belirleyin ve eklenecek ürünleri seçin.
Seçili ürünleri WHMCS'e ekleyin. SAN destekleyen ürünlerde Configurable Options kendiliğinden oluşturulur.
Elle oluşturma:Setup → Products/Services altında yeni bir ürün açın (Product Type: Other), Module Settings sekmesinde modül olarak "DATASSL SSL Certificates" seçin ve listeden ilgili sertifika ürününü eşleştirin. Liste boş geliyorsa API bağlantısını kontrol edin.
Cron ekleyin (önerilir)
Sipariş durumlarının düzenli eşitlenmesi için addon içindeki cron dosyasını zamanlayın:
DATASSL modülünü bulun ve Bağlantı Testi ile API bağlantısını doğrulayın.
Ürün oluşturun
Ürünler/Servisler altında yeni bir ürün ekleyin ve modül olarak DATASSL seçin.
İlgili sertifika ürününü eşleştirin; fiyatlandırma ve SAN ayarlarını yapın.
Ürünü kaydedin. Sipariş geldiğinde modül siparişi API üzerinden oluşturur.
CSR ve özel anahtar: Müşteriniz CSR'ı kendi sunucusunda oluşturup müşteri panelinden girer. Özel anahtar (private key) ne modülde ne de tarafımızda üretilir veya saklanır. CSR girilmeden verilen siparişler "yapılandırma bekliyor" durumunda kalır.
WHMCS
Addon Paneli Sayfaları
Genel Bakış
API durumu, bakiye, sipariş sayıları ve son siparişler.
Ürün Oluşturucu
API ürünlerini kâr marjı belirleyerek toplu olarak WHMCS'e ekleme.
Siparişler
SSL siparişlerini listeleme, arama ve durum eşitleme.
İşlem Kayıtları
API çağrıları ve hata kayıtları.
Ayarlar
Bağlantı testi, modül bilgileri ve cron durumu.
Özet
Modül Karşılaştırması
Özellik
WHMCS
WiseCP
Sürüm
v5.11.0
v2.4.0
Yapı
Sunucu modülü + addon modülü
Ürün modülü
API anahtarı
Modüle gömülü
Modüle gömülü
Toplu ürün ekleme
Var (Ürün Oluşturucu)
Yok (ürünler tek tek eklenir)
Sipariş eşitleme
Bağımsız cron veya WHMCS günlük cron'u
Panel üzerinden durum eşitleme
E-posta şablonları
5 şablon kurulumda eklenir
WiseCP'nin kendi bildirimleri
SAN / Wildcard SAN
Var (Configurable Options)
Var
Müşteri panelinde CSR ve DCV adımları
Var
Var
Sertifika indirme
Var
Var
Süre bitimi hatırlatması
30, 14, 7, 3 ve 1 gün kala
WiseCP'nin kendi bildirimleri
Sorular
Sık Sorulan Sorular
API anahtarımı nereye girmeliyim?
Hiçbir yere. Modülü bayi hesabınızla indirdiğinizde API adresi ve anahtarınız dosyalara gömülü gelir.
Modülü nasıl güncellerim?
Yeni sürümü indirip dosyaları mevcut klasörlerin üzerine yükleyin. WHMCS addon modülü eksik tablo ve e-posta şablonlarını kendisi tamamlar; kayıtlı siparişleriniz korunur.
Ürün listesi boş geliyor, ne yapmalıyım?
Genellikle bağlantı veya hesap ayarı kaynaklıdır:
cURL eklentisi etkin mi?
Sunucunuzun güvenlik duvarı dışarıya HTTPS bağlantısına izin veriyor mu?
Bayi hesabınız aktif ve bir fiyat grubu tanımlı mı?
WHMCS'te Ayarlar → Bağlantı Testi sonucunu kontrol edin, ardından ürün listesini yenileyin.
Müşteri CSR girmeden sipariş verebilir mi?
Evet. Sipariş "yapılandırma bekliyor" durumunda açılır; müşteri daha sonra kendi panelinden CSR ve doğrulama yöntemini girerek başvuruyu tamamlar.
Sipariş tutarı bakiyemden ne zaman düşer?
Sipariş API üzerinden oluşturulduğu anda, KDV dahil tutar bakiyenizden düşülür. Bakiye yetersizse sipariş oluşturulmaz ve modül hatayı gösterir.
Sertifikalar otomatik olarak yeniden düzenleniyor mu?
Hayır. SSL sertifikaları en fazla 199 gün geçerli düzenlenir. Hizmet süresi devam ederken yeniden düzenleme (reissue) ücretsizdir ve müşteri panelinden veya yönetici panelinden başlatılır.
Kod imzalama sertifikaları destekleniyor mu?
Kod imzalama ürünlerinde alan adı ve DCV adımı istenmez. Bu ürünlerde kuruluş doğrulaması ve belge süreci bulunduğundan, siparişi vermeden önce ürün sayfasındaki koşulları inceleyin; gerekirse destek ekibimizle görüşün.
Destek
Sorun Giderme
Sorun
Çözüm
WHMCS: Addon menüde görünmüyor
Setup → Addon Modules altında etkinleştirildiğini ve yönetici rolünüzün seçildiğini kontrol edin.
WHMCS: Modül listede yok
modules/servers/datassl.php dosyasının doğru yolda olduğunu kontrol edin.
WHMCS: Ürün oluşturulamıyor
Önce bir ürün grubu (Product Group) oluşturulmuş olmalıdır.
API bağlantı hatası
Sunucunuzun dışarıya HTTPS bağlantısına izin verdiğini, cURL ve JSON eklentilerinin etkin olduğunu doğrulayın.
"Geçersiz API anahtarı"
Anahtarınızı yenilediyseniz modülü yeniden indirip dosyaları güncelleyin. Bayi panelinde API erişiminin açık olduğunu kontrol edin.
Sipariş oluşturulamıyor
Bakiyenizi kontrol edin. WHMCS'te ayrıntılı hata için Utilities → Logs → Module Log kaydına bakın.
Çok sık istek hatası (429)
API dakikada 60 istekle sınırlıdır. Cron sıklığını azaltın ve bir süre sonra yeniden deneyin.
Sertifika indirilemiyor
Sertifika henüz düzenlenmemiş olabilir. Durumu eşitleyin ve doğrulamanın tamamlandığını kontrol edin.
Cron çalışmıyor
PHP yolunu (which php) ve cron kayıtlarını kontrol edin.
Kurulumda yardıma mı ihtiyacınız var?
Destek ekibimiz mesai saatlerinde kurulum ve entegrasyon sorularınızı yanıtlar.
