Faturalama entegrasyonları

#Nasıl çalışır

Fatura sistemindeki modül, panelin faturalama API'sine HTTPS üzerinden bağlanır ve hesapları kullanıcı adıyla yönetir. Her çağrı, fatura sistemi için oluşturduğunuz tokenla yapılır ve paneldeki Eşitleme ve işlem günlüğüne yazılır. Token yalnızca faturalama uçlarında geçerlidir; panele normal oturum açmak veya genel API'yi kullanmak için işe yaramaz ve onu oluşturan yöneticinin ya da bayinin yetkileriyle çalışır.

Sayfa Sunucu Yönetimi → Faturalama entegrasyonları menüsündedir ve dört sekmeden oluşur:

Özellik Topluluk ve Pro sürümlerinde aynıdır. Topluluk sürümünde en fazla 3 barındırma hesabı açılabildiği için sınır dolduğunda hesap açma isteği bir hata mesajıyla reddedilir; bayi hesabı satmak Pro sürüm gerektirir. Sürüm farkları için Fiyatlar sayfasına bakın.

#Modül dosyalarını indirme

Kurulum sekmesindeki Modül paketleri bölümünde WHMCS ve Blesta için birer indirme düğmesi bulunur. Paket, indirme anında bu sunucudaki dosyalardan ZIP olarak üretilir; bu yüzden panel her güncellendiğinde modülün o sürüme uygun hâlini alırsınız. Arşivdeki yollar fatura sisteminin kök dizinine göredir:

Panel bir güncellemeden sonra yeni modül dosyaları getirdiyse paketi yeniden indirip aynı yere açmanız yeterlidir.

#Fatura sistemi tokenı

Tokenlar sekmesinde Token oluştur düğmesine basın ve şu alanları doldurun:

Token bpb_ önekiyle başlar ve yalnızca oluşturulduğu anda bir kez gösterilir; panel yalnızca özetini saklar. Kişi başına en fazla 20 token oluşturulabilir. Bir tokenı iptal ettiğinizde onunla üretilmiş ve henüz kullanılmamış giriş bağlantıları da geçersiz olur. Tokenın sahibi yönetici veya bayi rolünü kaybederse ya da askıya alınırsa token çalışmaz. Süreli destek yöneticileri token oluşturamaz.

#Sertifika sabitleme

Modül bağlantıda sertifika doğrulamasını kapatmaz. Panelin sertifikası genel bir sertifika otoritesince doğrulanmıyorsa (örneğin kurulumda üretilen kendinden imzalı sertifika), sayfa sertifikanın açık anahtar özetini pin-sha256=… biçiminde verir ve modül yalnızca o anahtarı taşıyan sertifikayı kabul eder. Bu durumda token oluşturulurken WHMCS için iki satırlık bir Erişim Anahtarı (Access Hash) değeri gösterilir: ilk satır token, ikinci satır sabitleme değeridir. Sunucuya geçerli bir sertifika kurduğunuzda sabitleme gerekmez; ayrıntılar SSL sertifikaları sayfasında.

#Bayi tokenları

Bayiler (bayilik Pro sürümdedir) de bu sayfayı açıp kendi tokenlarını oluşturabilir. Bayi tokenı yalnızca bayinin kendi hesaplarını görür ve bayi yetkilerine tabidir: hesap oluşturma, askıya alma, silme, paket ve parola değişikliği ile müşteri paneline giriş için bayinin ilgili yetkisi olmalıdır. Bayiler bayi hesabı açamaz. Bayilik için Bayilik, ekip ve marka sayfasına bakın.

#WHMCS kurulumu

1. Modül paketini WHMCS kök dizininde açın.
2. Sistemi WHMCS olan bir token oluşturun ve izinli IP listesine WHMCS sunucusunun adresini ekleyin.
3. WHMCS'te Sistem Ayarları → Sunucular → Yeni sunucu ekle ekranında modül olarak bipanel seçin, ana makine adını girin ve SSL modunu işaretleyin. Port, Sunucu Yönetimi portudur: sunucu kurulumunda 2087, konteyner kurulumunda genellikle 443; doğru değer Kurulum sekmesinde yazar.
4. Tokenı Erişim Anahtarı (Access Hash) alanına yapıştırın (sabitleme gerekiyorsa ikinci satırıyla birlikte). Kullanıcı adı ve parola boş kalabilir. Bağlantıyı test et ile deneyin.
5. Ürünler/Hizmetler altında ürünün Modül Ayarları sekmesinde modül olarak bipanel ve sunucu grubunu seçin, ardından ürün seçeneklerini ayarlayın.

Kullanım eşitleme için WHMCS Otomasyon ayarlarındaki disk ve bant genişliği güncelleme seçeneği açık olmalıdır; modül günlük cron çalışmasında her hesabın disk ve bant genişliği kullanımını ve paket sınırlarını hizmet kayıtlarına yazar. Paneldeki mevcut hesapları WHMCS'e almak için Sunucular sayfasındaki hesap eşitleme (Sync Accounts) aracını kullanabilirsiniz; hesaplar alan adıyla eşleştirilir. Yönetim alanındaki hizmet ekranında hesabın paneldeki durumu, paketi, disk ve bant genişliği kullanımı, alan adı / veritabanı / e-posta sayıları ve son giriş zamanı gösterilir. Modül çağrıları WHMCS modül günlüğüne token ve parolalar maskelenerek yazılır.

#Blesta kurulumu

1. Modül paketini Blesta kök dizininde açın.
2. Sistemi Blesta olan bir token oluşturun.
3. Blesta'da Ayarlar → Şirket → Modüller → Kullanılabilir sekmesinden bipanel modülünü kurun ve bir sunucu ekleyin: sunucu adı, ana makine adı, port (sunucu kurulumunda 2087, konteyner kurulumunda genellikle 443), SSL kullan ve API tokenı. Panel kendinden imzalı sertifika kullanıyorsa sabitleme değerini Sertifika sabitleme alanına girin. Kayıt sırasında panele bağlanılıp token denenir.
4. Paketler → Paket oluştur ekranında modül olarak bipanel ve sunucuyu seçin; bipanel paketini listeden seçin, isterseniz Bayi hesabı ve Kalıcı silme seçeneklerini açın.

Blesta modülü hizmet için alan adı, kullanıcı adı ve parola alanları tutar; kullanıcı adı boş bırakılırsa alan adından üretilir. Müşteriler hizmetin Kontrol paneli sekmesinden tek tıkla panele girer ve hızlı erişim düğmelerini kullanır; yöneticiler hizmetin bipanel sekmesinde hesabın paneldeki durumunu ve kullanımını görür. Blesta modülü disk ve bant genişliği eşitlemesi yapmaz, hesap içe aktarma aracı da yoktur.

#Hizmet yaşam döngüsü

Hesap açılırken kullanıcı adı panel kurallarına (küçük harfle başlar, 2–16 karakter, yalnızca a-z ve 0-9) uymuyorsa modül uygun bir ad üretir; ad alınmışsa en fazla üç farklı ad dener ve sonucu fatura sistemindeki hizmete kaydeder. Parola kurallara (8–128 karakter; boşluk, tırnak ve ters eğik çizgi yok) uymuyorsa WHMCS modülü güçlü bir parola üretip hizmete kaydeder.

#Paket eşleme

Ürün veya paket ayarındaki değer, paneldeki bir paketin adıyla eşleşir (büyük/küçük harf farkı gözetilmez). Liste, tokenın sahibinin atayabileceği paketlerden oluşur: sunucu yöneticisi tüm paketleri, bayi kendi paketlerini ve kendisiyle paylaşılanları görür. Paket panelde bulunamazsa işlem hata verir; paket adını Sunucu Yönetimi → Paketler ile karşılaştırın. Paketler için Hesaplar ve paketler sayfasına bakın.

#Silme ve arşiv

Pro sürümde Silinen hesaplar açıksa ve ürünün Kalıcı silme seçeneği kapalıysa sonlandırılan hesap önce arşivlenir ve ayarlanan süre boyunca geri yüklenebilir. Topluluk sürümünde ya da Kalıcı silme açıkken hesap hemen ve kalıcı olarak silinir.

#Tek tıkla giriş

Müşteri fatura sistemindeki giriş düğmesine bastığında modül panelden tek kullanımlık, kısa ömürlü bir giriş bağlantısı ister ve tarayıcıyı oraya yönlendirir. Bağlantının ömrü varsayılan olarak 120 saniyedir ve Ayarlar sekmesinden 30–900 saniye arasında değiştirilebilir; aynı sekmedeki Fatura sisteminden tek tıkla giriş anahtarı özelliği sunucu genelinde kapatır. WHMCS modülü müşteri alanındaki ürün ayrıntıları sayfasına dosyalar, e-posta, veritabanları, alan adları, DNS, SSL, yedekler, FTP, cron ve PHP gibi sayfalara giden hızlı erişim bağlantıları ekler. Bayi olarak işaretli hizmetlerde giriş düğmesi Sunucu Yönetimini açar.

Bazı kurallar her zaman geçerlidir:

• Askıya alınmış hesaplar ve sunucu yöneticisi hesapları tek tıkla giriş yapamaz.
• Tokenın sahibi olarak Sunucu Yönetimine giriş yalnızca Sunucu Yönetimine tek tıkla giriş izni açık bir tokenla ve fatura sisteminin yönetim alanından istenebilir. Bu izin açıkken token iki aşamalı doğrulama sorulmadan Sunucu Yönetimi oturumu açabildiği için izinli IP listesini doldurun.
• Fatura sisteminin yönetim alanından istenen girişler "olarak giriş" oturumu sayılır ve sunucudaki destek erişimi izni kurallarına tabidir.

#Sorun giderme

Önce Günlük sekmesine bakın: başarısız her çağrı hata mesajı ve kaynak IP ile görünür. Sık karşılaşılan durumlar:

Faturalama API'si ile genel API tokenları arasındaki fark için API ve komut satırı sayfasına bakın.