WHMCS Core Paraşüt Modülü
WHMCS müşteri, ürün, fatura ve ödeme kayıtlarını Paraşüt hesabıyla kontrollü sırada eşitler.
Ön koşullar
- WHMCS 8.x/9.x desteklenen sürüm
- PHP 7.4+
- PHP cURL, JSON, mbstring ve OpenSSL
- Paraşüt geliştirici uygulaması, Client ID, Client Secret ve şirket/Firma ID
- E-Fatura/E-Arşiv işlemleri için Paraşüt hesabında ilgili hizmetin aktif olması
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/coreparasut/
-
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
OAuth uygulaması
Paraşüt geliştirici panelinde uygulama oluşturun ve yönlendirme adresini modülün oauth.php adresiyle aynı tanımlayın.
Bağlantı
Client ID, Client Secret ve Firma ID alanlarını kaydedip modülün bağlantı testini çalıştırın.
Eşitleme sırası
İlk aktarımı müşteri → ürün → fatura → ödeme sırasıyla ve küçük bir veri kümesiyle başlatın.
Cron
Otomatik eşitleme gerekiyorsa gerçek PHP ve WHMCS yollarınıza göre zamanlayın.
*/10 * * * * php -q /WHMCS_PATH/modules/addons/coreparasut/cron.php
Testler
- Tek bir test müşterisini eşitleyin ve Paraşüt'teki vergi/adres alanlarını karşılaştırın.
- Tek ürünlü kontrollü fatura oluşturup KDV eşlemesini doğrulayın.
- Aynı kaydı yeniden eşitlediğinizde mükerrer müşteri veya fatura oluşmadığını kontrol edin.
Güvenlik
- OAuth sırlarını kaynak koduna veya günlük çıktısına yazmayın.
- Canlı toplu eşitlemeden önce veritabanı yedeği alın ve tek kayıtla prova yapın.
Sorun giderme
Yetkilendirme başarısız
OAuth yönlendirme adresi, Client ID/Secret, Firma ID ve sunucu saatini kontrol edin.
Vergi oranı eşleşmiyor
Sabit eski oranları kullanmayın; WHMCS ve Paraşüt'teki güncel vergi kodu eşlemesini kontrol edin.