WHMCS Core Komisyon Modülü
Fatura, bayi ve satış ortağı bazlı komisyonları kurallara göre hesaplar; dönem raporları ve ödeme takibi sunar.
Ön koşullar
- WHMCS 8.x/9.x desteklenen sürüm
- PHP 7.4+
- WHMCS cron görevinin çalışıyor olması
- Komisyon oranları, vergi/kesinti politikası ve bayi yapısının önceden belirlenmesi
Kurulum adımları
-
1
Yedek ve ön kontrol
WHMCS dosyaları ile veritabanını yedekleyin; işlemi önce staging ortamında uygulayın.
-
2
Dosyaları yükleyin
Paket dizin yapısını bozmadan şu hedeflere yükleyin: modules/addons/corekomisyon/
-
3
İzinleri doğrulayın
Klasörleri normalde 750/755, dosyaları 640/644 tutun; web sunucusu sahibini doğru ayarlayın ve 777 kullanmayın.
-
4
Modülü etkinleştirin
WHMCS > Sistem Ayarları > Eklenti Modülleri bölümünde modülü etkinleştirin ve gerekli yönetici rollerine erişim verin.
-
5
İlk yapılandırmayı kaydedin
Aşağıdaki modüle özel alanları doldurun; test tamamlanmadan canlı ortam/kimlik bilgilerine geçmeyin.
Yapılandırma
Genel kurallar
Hesaplama zamanını, varsayılan oranı, para birimini, yuvarlama ve iptal/iade davranışını tanımlayın.
Ürün ve bayi kuralları
Ürün, ürün grubu veya bayi için özel oranları tanımlayın; kademeli oranların birbiriyle çakışmadığını kontrol edin.
Dönem ve bildirim
Hak ediş dönemini, ödeme vadesini ve gönderilecek yönetici/bayi bildirimlerini yapılandırın.
Cron
Paketinizde bulunan görevleri yalnızca gerçek dosya yollarını doğruladıktan sonra zamanlayın.
php -q /WHMCS_PATH/modules/addons/corekomisyon/cron.phpTestler
- Ödenmiş kontrollü bir test faturasında beklenen komisyonu elle hesaplayıp modül sonucu ile karşılaştırın.
- İptal/iade senaryosunda komisyonun geri alınmasını doğrulayın.
- Aynı fatura için cron tekrar çalıştığında mükerrer kayıt oluşmadığını kontrol edin.
Güvenlik
- Aktivasyon sorunu için tabloları elle oluşturmayın; paketle gelen resmi aktivasyon/migrasyon işlemini yeniden çalıştırın.
- Komisyon dışa aktarımlarını ve bayi raporlarını yalnızca yetkili yönetici rollerine açın.
Sorun giderme
Komisyon oluşmuyor
Faturanın ödeme durumunu, etkin kuralı, tarih aralığını ve WHMCS cron geçmişini kontrol edin.
Tutar yanlış
Öncelikli ürün/bayi kuralı, vergi kesintisi, kur dönüşümü ve yuvarlama ayarlarını birlikte inceleyin.