WHMCS Domain Registrar Modülü

Domain Name API WHMCS modülü, WHMCS kurulumunuzu doğrudan Domain Name API'nin domain kayıt ve SSL altyapısına bağlayan bir registrar eklentisidir. Kurulduktan sonra WHMCS; domain kaydı, yenileme, transfer, DNS yönetimi ve WHOIS güncellemelerini müşterileriniz adına otomatik olarak gerçekleştirir — sizin veya ekibinizin herhangi bir manuel işlem yapmasına gerek kalmaz. Faturalama, ödeme takibi ve son kullanma tarihi bildirimleri de otomatik olarak yönetilir.

Modül; .com, .net, .org gibi tüm büyük gTLD'lerin yanı sıra .tr, .com.tr, .de, .uk, .us, .cn, .ru, .in ve .ge dahil bölgesel ccTLD'ler olmak üzere 700'den fazla domain uzantısını destekler. cPanel, Plesk, DirectAdmin, SolusVM ve tüm büyük hosting kontrol panelleriyle uyumludur.

💡 WHMCS modülünü, vitrininiz ile domain kayıt kuruluşu arasındaki köprü olarak düşünebilirsiniz. Olmadan her sipariş manuel işlem gerektirir; kurulunca tüm domain işletmeniz otomatik pilotta çalışır. Türkiye ve MENA bölgesini hedefleyen bayiler için yerleşik .tr ve .com.tr desteği ile T.C. Kimlik No ve Vergi Numarası alan eşleştirmesi, yasal uyumu başından itibaren kolaylaştırır.

Domain Name API WHMCS modülünün kurulumu genellikle 10 dakika kadar sürer. Ekran görüntülü adım adım rehber bilgi bankamızda; bu sayfadaki video da aynı adımları gösterir.

1. En güncel sürümü GitHub Releases sayfasından indirin. Yeşil “Code → Download ZIP” düğmesini kullanmayın; o, geliştirme dalını indirir.

2. Arşivi açın ve modules klasörünü WHMCS kök dizinine kopyalayın (örn. /home/whmcs/public_html). .gitignore, README.md ve LICENSE dosyalarını yüklemeniz gerekmez.

3. WHMCS yönetim panelinde Sistem Ayarları → Domain Registrars bölümüne gidin. Dosyalar doğru yerdeyse DomainNameAPI listede görünür.

4. Modülü etkinleştirin ve Reseller ID ile API Key bilgilerinizi girin. İkisini de Domain Name API panelinizde (dm.apiname.com) API Ayarları bölümünde bulursunuz; panel giriş bilgileriniz burada çalışmaz. Kaydettiğinizde bakiyeniz görünür.

5. .tr domain satıyorsanız T.C. Kimlik No ve Vergi No alanlarını ilgili müşteri özel alanlarıyla eşleştirin.

6. Fiyatları Utilities → Registrar TLD Sync → DomainNameApi ile içe aktarın ya da elle girin.

7. Sistem Ayarları → Genel Ayarlar → Domainler altında kayıt, transfer, yenileme siparişleri, ödemede otomatik yenileme, domain senkronu ve IDN desteğini açın. Otomasyon Ayarları altında Domain Sync ve Sync Next Due Date seçeneklerini etkinleştirin.

⚠ Önemli: Önceki bir sürümden güncelliyorsanız üzerine yazmadan önce mevcut modül dosyalarınızı yedekleyin.

💡 En sık yapılan kurulum hatası dosyaları yanlış klasöre koymaktır; WHMCS bu durumda modülü sessizce görmez. Sorun gidermek için Utilities → Logs → Module Log ekranını hata ayıklama günlüğü açıkken kullanın, canlı ortamda bu günlüğü yeniden kapatın.

Domain Name API WHMCS modülünün gereksinimleri:

WHMCS 7.8 veya üzeri (en güncel kararlı sürüm önerilir)

PHP 7.4 veya üzeri (PHP 8.1 önerilir)

PHP cURL ve JSON eklentileri (çoğu hosting sunucusunda varsayılan olarak açıktır)

Kimlik No, Vergi No ve Vergi Dairesi için müşteri özel alanları — yalnızca .tr domain kayıtlarında gerekir

💡 Her zaman en güncel kararlı WHMCS sürümünü kullanın; güvenlik yamaları düzenli yayımlanır ve eski sürümler sık rastlanan bir saldırı yüzeyidir. Türkiye pazarına satış yapıyorsanız T.C. Kimlik No ve Vergi No alanlarını ilk yapılandırmada kurun: .tr kayıt otoritesi bunları zorunlu tutar.

WHMCS, uygun fiyatlı lisans modeli, kapsamlı entegrasyon ekosistemi ve olgun otomasyon altyapısı sayesinde dünya genelinde en yaygın kullanılan hosting otomasyon platformudur. Tek bir WHMCS kurulumu; müşteri kayıtlarını, faturalamayı, otomatik servis aktivasyonunu, ödeme takibini ve askıya alma/sonlandırma akışlarını yönetir. E-posta ve SMS bildirim sistemi, müşterileri her adımda manuel müdahale gerektirmeksizin bilgilendirir.

💡 Bugün platform seçiyorsanız karar vermeden önce WHMCS'in maliyetini WiseCP (özellikle Türkiye ve MENA pazarında rekabetçi) ve Blesta (tek seferlik lisans, güçlü veri sahipliği) ile karşılaştırın. Domain Name API üç platformu da kendi modülleriyle destekler.

Domain Name API ile tam uyumlu, aktif olarak geliştirilen WHMCS alternatifleri:

Blesta — geliştirici dostu, tek seferlik lisans, güçlü veri taşınabilirliği

HostBill — kurumsal düzey, 150'den fazla entegrasyon, yüksek hacimli bayiler için ideal

WiseCP — modern arayüz, Türkiye ve MENA bölgesinde hızla büyüyor

ClientExec — daha basit özellik seti, bütçe dostu başlangıç seçeneği

HostFact — Hollanda ve Batı Avrupa'da yaygın

AWBS, WHMAutoPilot, Lpanel, Modernbill ve PerlBill gibi eski platformlar artık aktif geliştirilmemekte olup yeni kurulumlar için önerilmez.

💡 Platform seçimi hedef pazarınıza göre şekillenmelidir. WHMCS global operasyonlar için en güvenli seçimdir. WiseCP, Türkiye pazarındaki bayiler arasında hızla öne çıkan alternatiftir ve Domain Name API'nin özel WiseCP modülüyle tam desteklenmektedir. HostBill 150+ entegrasyon ihtiyacı olan kurumsal bayiler için, Blesta ise tam veri sahipliği ve tek seferlik maliyet arayan operatörler için önerilir.

WHMCS, WHMCS Ltd. tarafından lisanslanan ücretli bir yazılımdır; planları aktif müşteri sayısına göre fiyatlanır ve aylık faturalanır. Satın almadan önce güncel planları ve deneme seçeneklerini whmcs.com üzerinden kontrol edin.

Domain Name API WHMCS modülü ise ücretsizdir ve tüm WHMCS lisans katmanlarıyla çalışır. Yalnızca kaydettiğiniz domainlerin ücretini bayi fiyatlarınızla ödersiniz.

Evet. WHMCS Ltd. lisans katmanları arasında geçişe izin verir; güncel yükseltme koşullarını whmcs.com üzerinden kontrol edin. Domain Name API modülü tüm WHMCS lisans katmanlarıyla çalıştığı için plan değiştirmeniz registrar ayarlarınızı etkilemez.

💡 Bugünkü aktif müşteri sayınıza uyan katmanla başlayın, büyüdükçe yükseltin; modül yapılandırmanız olduğu gibi kalır.

Domain Name API WHMCS modülü; .com, .net, .org, .info, .biz gibi tüm büyük gTLD'ler ile .tr, .com.tr, .de, .uk, .us, .cn, .ru, .in, .ge ve daha pek çok ccTLD dahil olmak üzere 700'den fazla domain uzantısını destekler. Premium fiyatlandırma sunan kayıt kuruluşları için premium domain kaydı da desteklenmektedir.

💡 Belirli coğrafi pazarları hedefleyen bayiler, TLD fiyat tablolarını yerel uzantılara öncelik verecek şekilde düzenlemelidir. Türkiye'deki bayiler .tr ve .com.tr uzantılarını öne çıkarmalıdır — bu uzantılar yerel müşterilerde güçlü güven sinyali oluşturur ve dönüşüm oranlarını artırır. Yerelleştirilmiş TLD konumlandırması, GEO hedefli SEO kampanyalarında en yüksek ROI sağlayan taktiklerden biridir.

WHMCS, varsayılan olarak beş dakikada bir çalışan otomatik cron job aracılığıyla domain son kullanma tarihlerini kontrol eder. Bir domainin bitiş tarihi yaklaştığında WHMCS otomatik olarak müşteriye yenileme faturası oluşturur, yapılandırılabilir aralıklarla (genellikle 60, 30, 14 ve 7 gün öncesinde) son kullanma tarihi bildirimleri gönderir ve müşteri hesabında yeterli bakiye veya geçerli ödeme yöntemi varsa yenilemeyi otomatik gerçekleştirir.

Bu işlemin doğru çalışması için Sistem Ayarlari > Genel Ayarlar > Domains altında Domain Sync'in aktif olması gerekir; böylece WHMCS her zaman Domain Name API'den güncel son kullanma tarihlerini alır.

💡 Bitişten önceki haftalara yayılmış birkaç hatırlatma, tek bir e-postaya göre çok daha zor gözden kaçar. Otomasyon Ayarları altında Sync Next Due Date seçeneğinin de açık olduğundan emin olun; WHMCS ile kayıt otoritesindeki bitiş tarihleri arasındaki farklar, bayilerde beklenmedik domain düşmelerinin başlıca nedenlerindendir.

Domain fiyatlandırması her TLD için manuel girilebilir ya da Registrar TLD Sync aracıyla otomatik içe aktarılabilir. Otomatik senkronizasyon için: Utilities > Registrar TLD Sync bölümüne gidin, DomainNameApi'yi seçin ve karşılaştırmanın tamamlanmasını bekleyin. Sonuç ekranı her uzantı için kâr/zarar marjlarını gösterir ve toplu fiyat aktarımı yapmanıza olanak tanır.

Domain Name API'yi Lookup Provider olarak da ayarlayabilirsiniz (Sistem Ayarlari > Domain Fiyatları > Lookup Provider > Değiştir > DomainNameApi). Bu sayede genel WHOIS sunucuları yerine Domain Name API altyapısından gerçek zamanlı uygunluk sorgusu yapılır.

💡 Otomatik fiyat senkronizasyonu WHMCS'nin en az kullanılan özelliklerinden biridir. TLD Sync'i aylık çalıştırmak, tedarikçi fiyat değişikliklerinden sonra bile perakende fiyatlarınızın maliyet üzerinde kalmasını sağlar. Sabit marj kuralı (örn. maliyet + %25) 700'den fazla uzantıda kârlılığı manuel inceleme gerektirmeden korur.

WHMCS, entegrasyon sorunlarını teşhis etmek için yerleşik bir modül kayıt sistemi sunar. Utilities > Logs > Module Log bölümüne gidin. Enable Debug Logging butonu görünüyorsa tıklayarak etkinleştirin. Etkinleştirildikten sonra WHMCS ile Domain Name API arasındaki tüm istek ve yanıtlar kaydedilir. Herhangi bir log kaydının tarihine tıklayarak tam istek, yanıt ve filtrelenmiş yanıt detaylarını inceleyebilirsiniz.

Sık karşılaşılan sorunlar:

Modül dosyalarının yanlış dizine yüklenmesi — WHMCS modülü sessizce algılamaz

Hatalı API kimlik bilgileri — kayıt sonrasında bakiye görüntülenmez

Domain sync'in devre dışı olması — son kullanma tarihleri eskir ve yenilemeler sessizce başarısız olur

💡 Destek ekibiyle iletişime geçmeden önce başarısız işlemin Module Log kaydını alın. Filtrelenmiş yanıt bölümü, Domain Name API'nin döndürdüğü hatayı tam olarak gösterir; çoğu durumda sorun kendiliğinden anlaşılır. Bu logu hazır bulundurmak çözüm sürecini önemli ölçüde kısaltır. Performans etkisini önlemek için üretim ortamında debug logging'i kapalı tutun.

Domain transferleri, registrar modülü aracılığıyla otomatik olarak işlenir. Bir müşteri gelen transfer başlattığında WHMCS, müşterinin sağladığı EPP yetkilendirme kodunu kullanarak Domain Name API'ye transfer talebini iletir. Transfer durumu ve anlık başlangıç/bitiş tarihleri yönetici panelinde gerçek zamanlı görüntülenebilir. Yöneticiler, domain yönetim panelinden doğrudan transfer iptali talebi de oluşturabilir.

💡 Transfer başarısızlıkları en sık süresi dolmuş EPP kodları, kayıt kuruluşu tarafındaki transfer kilitleri veya son kayıttan itibaren 60 günlük ICANN kilit süresi nedeniyle yaşanır. .tr domain transferlerinde özellikle dikkat edin: alıcı müşteri hesabındaki T.C. Kimlik No ve Vergi Numarası bilgileri kayıt kuruluşundaki kayıtlarla eşleşmelidir; uyumsuzluklar log incelemesi yapılmadan teşhis edilmesi güç sessiz transfer reddine yol açar.