Kısa Cevap — WHMCS'te yüzlerce TLD fiyatını tek tek elle güncellemek yerine, Domain Name API modülünü kullanarak Utilities > Registrar TLD Sync ekranından tüm uzantıların güncel maliyet fiyatlarını WHMCS'e aktarabilir, tanımladığınız kâr marjı kuralına göre satış fiyatını toplu olarak hesaplatabilirsiniz. Bu işlem WHMCS 7.10 ve üzerinde, çekirdek bir WHMCS özelliği olan TLD & Pricing Sync aracı üzerinden çalışır; Domain Name API'nin WHMCS modülü bu aracı destekler.

30 Saniyede Özet

Adımlar

1. Domain Name API WHMCS modülünü kurun ve Reseller ID / API Key ile etkinleştirin.

2. Utilities > Registrar TLD Sync ekranına gidin.

3. Listeden DomainNameApi'yi seçin.

4. Kâr marjınızı (markup) yüzde veya sabit tutar olarak tanımlayın.

5. Uzantıları seçip fiyatları içe aktarın.

6. Bir test siparişiyle kayıt/yenileme/transfer fiyatlarını doğrulayın.

Giriş: Neden Manuel Fiyat Güncelleme Sürdürülebilir Değil?

Domain reseller işine 5-10 uzantıyla başlarsınız, fiyatları elle girersiniz, sorun olmaz. Ama portföyünüz 100, 300, 800 uzantıya çıktığında durum değişir. Registrar maliyetleri değişir, döviz kuru oynar, rekabet fiyatları kayar — ve her seferinde yüzlerce satırı tek tek WHMCS'te güncellemeniz gerekir.

Bu, üç somut soruna yol açar:

Zaman kaybı:

yüzlerce TLD'yi elle güncellemek saatler alır, bu süre satışa ayrılabilecek zamandır.

Maliyetin altında satış riski:

bir uzantının registrar maliyeti yükseldiğinde, fark edip fiyatı güncellemezseniz o uzantıyı zararına satmaya başlarsınız.

Tutarsız kâr marjı:

bazı uzantılarda %40 kâr, bazılarında %5 kâr olabilir, çünkü güncelleme rastgele ve düzensiz yapılır.

Bu rehberde, WHMCS'in çekirdeğinde gelen TLD & Pricing Sync aracını Domain Name API modülüyle birlikte nasıl kullanacağınızı; bunun gerçekte ne kadarının “otomatik” olduğunu; kurulumu, sık yapılan hataları ve en iyi uygulamaları adım adım göreceksiniz.

Bu rehber size uygunsa devam edin: WHMCS yöneticileri, domain bayileri, hosting firmaları, sistem yöneticileri ve Domain Name API modülünü WHMCS'e entegre eden yazılım geliştiriciler.

WHMCS'te Domain Fiyatlandırması Nasıl Çalışır?

WHMCS, bir uzantı için fiyat hesaplarken birden fazla bileşeni ayrı ayrı tutar. Bunları bilmeden senkronizasyon mantığını anlamak zor olur.

Bileşen Ne Anlama Gelir
Maliyet (Cost) Fiyatı Registrar'ın (Domain Name API'nin) size sunduğu, sizin ödediğiniz fiyat
Satış (Retail) Fiyatı Müşterinize gösterdiğiniz, kâr marjınızı içeren fiyat
Kayıt (Register) Süresi 1 ile 10 yıl arasında değişebilen, uzantıya göre farklı kayıt periyotları
Yenileme (Renew) Süre dolduğunda uygulanan fiyat; kayıt fiyatından farklı olabilir
Transfer Başka bir registrardan domain transferi için uygulanan fiyat
Redemption (Kurtarma) Süresi dolup grace period'u da geçen domainin kurtarılması için uygulanan, genelde yüksek fiyat
Para Birimi (Currency) Maliyet fiyatının tanımlı olduğu para birimi; WHMCS kurulumunuzda tanımlı olmalı
Premium Domain Standart fiyatlandırmanın dışında, registry tarafından özel fiyatlandırılan domainler

Bu bileşenlerin her biri, WHMCS'in domain registrar modül geliştirme dokümantasyonunda tanımlı standart alanlardır (registration/renewal/transfer price, grace fee, redemption fee, currency, EPP gereksinimi gibi). Domain Name API modülü de bu yapıyı kullanarak fiyat verisini WHMCS'e taşır.

Domain Name API ile TLD Fiyat Senkronizasyonu Nasıl Çalışır?

WHMCS 7.10 ile birlikte, çekirdeğe “TLD & Pricing Sync” (Registrar TLD Sync) adında bir araç eklendi. Bu araç, bu özelliği destekleyen registrar modülleri için ortak bir senkronizasyon ekranı sunar. Domain Name API'nin resmî WHMCS kurulum rehberi, bu aracın modülle birlikte nasıl kullanılacağını şöyle açıklar:

Resmî Kurulum Rehberinden — “Utilities” > “Registrar TLD Sync” ekranına gidin. Açılan ekranda “DomainNameApi”'yi seçin ve biraz bekleyin. Sonraki adımda, sistemdeki tüm TLD'ler WHMCS'teki TLD'lerle karşılaştırılır; kâr ve zarar marjları hesaplanıp toplu olarak görüntülenir, böylece içe aktarım (import) yapabilirsiniz.

Bu işlem sırasında ekranda göreceğiniz tablo, her uzantı için maliyet fiyatını, mevcut satış fiyatınızı ve aradaki marjı (yüzde veya tutar olarak) yan yana gösterir. Maliyetin altında satılan uzantılar görsel olarak vurgulanır, böylece zarar ettiğiniz noktaları kaçırmazsınız.

“Otomatik” Tam Olarak Neyi Kapsıyor? (Önemli Netleştirme)

Bu rehberin başlığı “otomatik senkronizasyon” dese de, burada dürüst olmak gerekir: WHMCS'in TLD & Pricing Sync aracı, Utilities menüsünden elle tetiklenen bir araçtır. Yani siz “Registrar TLD Sync” ekranına girip “DomainNameApi”i seçtiğinizde tüm uzantıların güncel maliyetini çekip kâr marjı kuralınıza göre yüzlerce satırı tek seferde günceller — bu kısım gerçekten otomatik ve toplu. Ama bu işlemi WHMCS'in kendiliğinden, belirli bir zaman aralığında (örneğin her gece) tekrar tekrar tetiklediğine dair resmî bir dokümantasyon bulunmuyor.

Otomatik Olan ile Manuel Tetiklenen Arasındaki Fark

Otomatik olan: yüzlerce TLD'nin maliyetini tek seferde çekip, tanımladığınız kâr marjı kuralına göre satış fiyatını toplu hesaplamak ve uygulamak.

Manuel olan: bu senkronizasyonu başlatma anı. Yani “Utilities > Registrar TLD Sync” ekranına girip işlemi tetiklemeniz gerekir; WHMCS bunu kendiliğinden, belirli bir takvime göre arka planda tekrarlamaz.

Karıştırılmaması gereken ayrı bir özellik: “Enable Domain Sync” (Genel Ayarlar > Domains) ve buna bağlı “Domain Sync Settings” (Otomasyon Ayarları), zaten kayıtlı domainlerin durumunu/bitiş tarihini senkronize eder — bu, TLD fiyat senkronizasyonundan tamamen farklı bir mekanizmadır ve cron üzerinden otomatik çalışır.

Pratik sonuç: fiyat senkronizasyonunu periyodik bir alışkanlık haline getirmeniz gerekir (örneğin ayda bir, veya registrar maliyetlerinde bilinen bir değişiklik olduğunda). Bunu tam otomatik bir cron görevine bağlamak isterseniz, bu WHMCS'in standart, dokümante edilmiş davranışının dışında, ek geliştirme gerektiren bir özelleştirme olur — bunu kesin bir özellik gibi sunmuyoruz.

Manuel Güncelleme mi, Registrar TLD Sync mi?

Kriter Manuel Güncelleme Registrar TLD Sync (Domain Name API ile)
Uygulama yöntemi Her uzantı tek tek elle düzenlenir Toplu, kural tabanlı (markup) uygulama
Harcanan zaman (yüzlerce TLD için) Saatler sürebilir Dakikalar içinde tamamlanır
Hata riski Yüksek (yazım/hesaplama hatası) Düşük (sistematik hesaplama)
Maliyetin altı satış riski Fark edilmezse uzun süre devam edebilir Maliyetin altındaki satırlar görsel olarak vurgulanır
Tetikleme şekli Her zaman elle Elle tetiklenir, ama hesaplama/uygulama toplu ve otomatik
Ölçeklenebilirlik Portföy büyüyünce sürdürülemez Portföy büyüklüğünden bağımsız çalışır

Senkronizasyonun Avantajları

WHMCS'in kendi ürün ekibinin de vurguladığı gibi, bu araç şu noktalarda doğrudan fayda sağlar:

Yeni başlayanlar için hızlı kurulum:

yüzlerce TLD'yi tek seferde, tanımladığınız kurallarla içe aktarabilirsiniz.

Henüz satmadığınız uzantıları keşfetme:

registrar'da mevcut olan ama WHMCS'te henüz satışa açmadığınız uzantıları kolayca görürsünüz.

Kâr marjını doğrulama:

her uzantı için gerçek kâr yüzdesini veya tutarını görürsünüz; maliyetin altında satılanlar vurgulanır.

Fiyat artışlarını yönetme:

registrar maliyeti değiştiğinde, satış fiyatınızı aynı oranda güncellemeniz kolaylaşır.

Toplu işlem:

yüzlerce satırı tek tek açıp kaydetmek yerine, kural tabanlı toplu güncelleme yaparsınız.

Yüzde veya sabit tutar bazlı markup:

kâr marjınızı yüzdelik veya sabit tutar olarak tanımlayabilirsiniz.

Yuvarlama (rounding) seçeneği:

hesaplanan satış fiyatını .50 veya .95 gibi akılda kalıcı, “kullanıcı dostu” bir değere yuvarlayabilirsiniz.

Hata payını azaltma:

elle veri girişinden kaynaklanan yazım/hesaplama hatalarını ortadan kaldırır.

Destek talebini azaltma:

yanlış fiyatlandırmadan kaynaklanan müşteri itirazları ve iç hatalar düşer.

Ölçeklenebilirlik:

portföyünüz büyürken fiyatlandırma operasyonu aynı hızda büyümek zorunda kalmaz.

Adım Adım Kurulum

1) Ön Koşullar

Kuruluma başlamadan önce şunları kontrol edin:

WHMCS 7.8 veya üzeri (TLD & Pricing Sync aracı WHMCS 7.10 ve sonrasında kullanılabilir)

PHP 7.4 veya üzeri (PHP 8.1 önerilir)

PHP SOAPClient eklentisi etkin olmalı

Domain Name API hesabınızdan alınmış Reseller ID ve API Key

Yükseltme Yapıyorsanız — Mevcut modülünüzü güncelliyorsanız, kurulumdan önce eski dosyalarınızı yedekleyin.

2) Modül Dosyalarının Yüklenmesi

İndirdiğiniz paketteki “modules” klasörünü WHMCS'in kurulu olduğu dizine kopyalayın (örnek: /home/whmcs/public_html). .gitignore, README.md ve LICENSE dosyalarını silmeyin.

Yaygın Hata — Dosyalar yanlış dizine yüklenirse, modül WHMCS tarafından hiç algılanmaz ve “Domain Name API” seçeneği Domain Registrars listesinde görünmez. Dosya yolunu mutlaka iki kez kontrol edin.

3) Modül Yapılandırması

PANEL YOLU
System Settings > Domain Registrars

WHMCS yönetim panelinde System Settings > Domain Registrars'a gidin.

Dosyalar doğru yere yüklendiyse “Domain Name API” burada görünür; üzerine tıklayıp etkinleştirin.

Size verilen Reseller ID ve API Key bilgilerini girin.

Kaydettiğinizde kullanıcı adınız ve güncel bakiyeniz görüntülenir.

Gerekirse, .tr uzantılı domainler için T.C. Kimlik No / Vergi No alanlarını ilgili özel alanlarla eşleştirin.

4) Domain Fiyatlandırma Ayarları

PANEL YOLU
System Settings > Domain Pricing

System Settings > Domain Pricing'e gidin.

Satmak istediğiniz uzantıları seçin (örnek: .com.tr).

Otomatik kayıt için “Domain Name API”i seçin.

EPP Code seçeneğini işaretleyin.

Fiyatları bu ekrandan elle girebilir, ya da bir sonraki adımdaki toplu senkronizasyonu kullanabilirsiniz.

İpucu: WHOIS Sorgu Sağlayıcısı — Genel WHOIS sunucuları yerine Domain Name API'yi sorgu kaynağı olarak kullanmak isterseniz, “Lookup Provider” altındaki “Change” seçeneğine tıklayıp “DomainNameApi”i seçebilir, bunu hangi uzantılar için uygulayacağınızı belirleyebilirsiniz.

5) Toplu Fiyat Senkronizasyonu (TLD & Pricing Sync)

PANEL YOLU
Utilities > Registrar TLD Sync

Utilities > Registrar TLD Sync ekranına gidin.

Listeden “DomainNameApi”i seçin ve verilerin çekilmesini bekleyin.

Sistemdeki tüm uzantılar WHMCS'teki uzantılarla karşılaştırılır; her biri için maliyet, mevcut satış fiyatı ve marj görüntülenir.

Markup kuralınızı (yüzde veya sabit tutar) ve isterseniz yuvarlama tercihinizi tanımlayın.

Hangi uzantıları içe aktaracağınızı/güncelleyeceğinizi seçip işlemi onaylayın.

WHMCS'te TLD Fiyatları Nasıl Senkronize Edilir? Otomatik Fiyat Güncelleme Rehberi

WHMCS'in çekirdek TLD & Pricing Sync ekranı: her uzantı için Register, Renew, Transfer ve Redemption bazında güncel maliyet ve marj görüntülenir; maliyetin altında kalan satırlar (görselde .net renew satırı) kırmızıyla vurgulanır.

6) Genel Ayarlar (Domains)

PANEL YOLU
System Settings > General Settings > Domains

System Settings > General Settings > Domains sekmesinde:

“Allow clients to register domains”:

Müşterilerin kendi başına domain kaydı yapmasına izin verir.

“Allow clients to transfer domains to you”:

Müşterilerin domain transferi başlatmasına izin verir.

“Enable renewal orders”:

Süre dolmadan önce yenileme siparişi oluşturulmasına izin verir.

“Automatic renewal on payment”:

Ödeme alındığında yenilemenin otomatik işlenmesini sağlar.

“Enable Domain Sync” (önerilir):

Mevcut domainlerin durumunu düzenli olarak kontrol eder ve senkronize eder — bu, fiyat senkronizasyonundan ayrı, domain durumu senkronizasyonudur.

“Allow IDN Domains”:

Türkçe, Arapça, Rusça gibi IDN domain desteğini açar.

Varsayılan Nameserver bilgilerinizi girin.

7) Senkronizasyon (Domain Sync) Ayarları

PANEL YOLU
System Settings > Automation Settings > Domain Sync Settings

System Settings > Automation Settings > Domain Sync Settings bölümüne gidin. Domain senkronizasyonunu etkinleştirin; bitiş tarihinin de güncellenmesini istiyorsanız “Sync Next Due Date”i açın. Diğer ayarları sunucu yükünüze göre belirleyin.

Hatırlatma — Bu bölüm, az önce bahsettiğimiz “otomatik” netleştirmesindeki ikinci mekanizmadır: var olan domainlerin durum/bitiş tarihi senkronizasyonu, cron üzerinden otomatik çalışır. TLD fiyat senkronizasyonu (Utilities > Registrar TLD Sync) ise ayrı, elle tetiklenen bir araçtır.

Senkronizasyon Sonrası Kontroller

Senkronizasyonu tamamladıktan sonra, canlıya geçmeden şu kontrolleri yapın:

Domain sorgulama:

müşteri tarafındaki domain arama ekranında fiyatların doğru göründüğünü test edin.

Kayıt (Registration):

bir test siparişiyle kayıt fiyatının doğru hesaplandığını doğrulayın.

Transfer:

transfer fiyatının ayrı ve doğru göründüğünü kontrol edin.

Yenileme (Renewal):

yenileme fiyatının kayıt fiyatından farklı olabileceğini unutmadan kontrol edin.

Redemption:

süresi dolan bir domainin kurtarma fiyatının mantıklı göründüğünü doğrulayın (genelde standart fiyattan yüksektir).

Premium domain'ler:

premium fiyatlandırmanın standart senkronizasyondan etkilenmediğini, ayrı yönetildiğini teyit edin.

En Sık Yapılan Hatalar

1) Fiyatlar senkronizasyon sonrası güncellenmiyor

Belirti: Senkronizasyon “tamamlandı” görünüyor ama satış fiyatları eskisiyle aynı

Sebep: İçe aktarım adımında ilgili uzantılar seçilmemiş veya onaylanmamış olabilir

Çözüm: Registrar TLD Sync ekranını tekrar açıp değişiklikleri açıkça seçip onaylayın

2) Currency (para birimi) uyuşmazlığı

Belirti: Fiyatlar anlamsız derecede yüksek veya düşük görünüyor

Sebep: Maliyet fiyatının tanımlı olduğu para birimi, WHMCS kurulumunuzdaki para birimiyle eşleşmiyor

Çözüm: Modül ve WHMCS para birimi ayarlarını karşılaştırın, gerekirse kur dönüşümünü doğru yapılandırın

3) Markup (kâr marjı) hiç uygulanmamış

Belirti: Satış fiyatı maliyetle aynı veya maliyetin altında

Sebep: Senkronizasyon sırasında markup kuralı tanımlanmadan içe aktarım yapılmış

Çözüm: TLD Sync ekranında markup yüzdesini/tutarını girip yeniden uygulayın

4) Registrar seçilmemiş

Belirti: İlgili uzantı için otomatik kayıt çalışmıyor

Sebep: Domain Pricing ekranında o uzantı için “Auto Registration” olarak “Domain Name API” seçilmemiş

Çözüm: Domain Pricing ayarlarından ilgili uzantıyı düzenleyip registrar'ı atayın

5) Modül algılanmıyor

Belirti: System Settings > Domain Registrars listesinde “Domain Name API” görünmüyor

Sebep: Modül dosyaları yanlış dizine yüklenmiş

Çözüm: Dosya yolunu kontrol edin (örnek: /home/whmcs/public_html/modules/registrars/...)

6) Unauthorized / Authentication Failed hatası

Belirti: Senkronizasyon veya domain işlemleri sırasında kimlik doğrulama hatası

Sebep: Reseller ID/API Key hatalı, IP Whitelist'te sunucu IP'si yok

Çözüm: Kimlik bilgilerini ve IP Whitelist'i kontrol edin — ayrıntılı rehberimize bakın

7) Invalid API Key hatası

Belirti: API Key geçersiz olarak reddediliyor

Sebep: Anahtar eski, yanlış kopyalanmış veya yenilenmiş ama güncellenmemiş

Çözüm: Entegrasyon Bilgileri sayfasından güncel anahtarı yeniden girin

8) Reseller Not Found hatası

Belirti: Sistem Reseller ID'yi tanımıyor

Sebep: Kullanıcı adı alanına e-posta yazılmış veya Reseller ID güncel değil

Çözüm: Reseller ID'yi e-posta yerine doğru alana girin — ayrıntılı rehberimize bakın

9) Maliyetin altında satış (negatif marj)

Belirti: TLD Sync ekranında bazı satırlar kırmızı/vurgulu görünüyor

Sebep: Registrar maliyeti yükselmiş ama satış fiyatı güncellenmemiş

Çözüm: İlgili uzantıları yeniden senkronize edip markup'ı uygulayın

10) Yenileme fiyatı kayıt fiyatından farklı unutuluyor

Belirti: Müşteriler yenilemede beklenmedik fiyatla karşılaşıyor

Sebep: Kayıt ve yenileme fiyatları ayrı alanlar olduğu fark edilmemiş

Çözüm: Her iki fiyatı da senkronizasyon ekranında ayrı ayrı kontrol edin

11) Premium domain fiyatları karışıyor

Belirti: Premium bir domain standart fiyattan satılıyor (zarar riski)

Sebep: Premium domain fiyatlandırması, standart TLD senkronizasyonuyla karıştırılmış

Çözüm: Premium domainleri ayrı bir fiyatlandırma mantığıyla yönetin, senkronizasyona güvenmeyin

12) Yuvarlama (rounding) beklenmedik sonuç veriyor

Belirti: Fiyatlar .99, .50 gibi beklenmedik basamaklara yuvarlanıyor

Sebep: Yuvarlama kuralı yanlış veya beklenmeden ayarlanmış

Çözüm: Yuvarlama tercihini gözden geçirip ihtiyacınıza göre kapatın veya değiştirin

13) Senkronizasyon “takılı” kalıyor / çok uzun sürüyor

Belirti: Registrar TLD Sync ekranı uzun süre yükleniyor

Sebep: Çok sayıda uzantı aynı anda işleniyor olabilir veya API isteği gecikiyor

Çözüm: Sayfayı yeniden yüklemeden bekleyin; tekrar ederse Module Log'dan API yanıt süresini kontrol edin

14) Eski modül sürümü kullanılıyor

Belirti: Senkronizasyon davranışı dokümantasyondakiyle uyuşmuyor

Sebep: Modül güncellenmemiş

Çözüm: GitHub'daki domainreseller organizasyonundan güncel sürümü indirip kurun

15) Module Log'da hata görünmüyor çünkü loglama kapalı

Belirti: Sorun var ama detay göremiyorsunuz

Sebep: Performans nedeniyle debug loglama kapatılmış (önerilen varsayılan)

Çözüm: Sorunu teşhis ederken geçici olarak “Enable Debug Logging”i açın, teşhis sonrası tekrar kapatın

Yukarıdaki kimlik doğrulama hataları (Unauthorized, Invalid API Key, Reseller Not Found) hakkında adım adım çözüm için:

Sorun Giderme Akışı

Fiyatlar Doğru Görünmüyorsa Sırasıyla Kontrol Edin

1. Senkronizasyon gerçekten tamamlandı mı, yoksa hata mı verdi? → Module Log'u kontrol edin.

2. Para birimi (currency) WHMCS kurulumunuzla eşleşiyor mu? → Eşleşmiyorsa düzeltip yeniden senkronize edin.

3. Markup kuralı tanımlı mı? → Tanımlı değilse ekleyip yeniden uygulayın.

4. İlgili uzantı için registrar doğru atanmış mı (Domain Pricing ekranı)? → Atanmamışsa atayın.

5. Kimlik doğrulama hatası (Unauthorized/Invalid API Key/Reseller Not Found) var mı? → İlgili rehberimize göre kimlik bilgilerini doğrulayın.

6. Hâlâ çözülmediyse: Module Log'da Enable Debug Logging'i açıp isteği/yanıtı inceleyin, gerekirse destek ekibine log ile birlikte başvurun.

En İyi Uygulamalar

Kâr Marjı (Markup) Nasıl Belirlenmeli?

Sabit bir doğru yüzde yoktur; rekabet, hedef pazar ve maliyet yapınıza göre değişir. Ancak iki noktaya dikkat etmenizi öneririz: kur oynaklığını karşılayacak bir tampon payı bırakmak, ve özel/popüler uzantılarda farklı bir marj stratejisi (örneğin .com'da daha düşük, niş uzantılarda daha yüksek marj) uygulamak.

Fiyatlar Ne Sıklıkla Senkronize Edilmeli?

Sabit bir kural yoktur, ama pratik bir öneri: kur hareketliliğinin yüksek olduğu dönemlerde ayda en az bir kez, registrar'ınızdan fiyat değişikliği bildirimi aldığınızda ise hemen senkronize edin. Senkronizasyonu “unutulan bir görev” olmaktan çıkarmak için takım içinde bir sorumluluk ve hatırlatıcı tanımlayın.

Döviz Kuru Nasıl Yönetilmeli?

Maliyet fiyatınız genelde USD bazlıysa ve WHMCS kurulumunuz farklı bir para biriminde çalışıyorsa, kur dönüşümünün doğru yapılandırıldığından emin olun. Bu konuyu, WiseCP tarafında ele aldığımız çoklu para birimi ve döviz kuru optimizasyonu rehberimizdeki mantık burada da geçerlidir: genel para birimi ayarları müşteri deneyimini, registrar maliyet senkronizasyonu ise kârlılığınızı belirler — ikisi birlikte doğru çalışmalıdır.

Premium Domain Yönetimi

Premium domainler, registry tarafından standart fiyatlandırmanın dışında, genelde çok daha yüksek fiyatlandırılır. Bu fiyatlar toplu TLD senkronizasyonuyla aynı mantıkla yönetilmez; WHMCS'in premium domain desteği ayrı bir mekanizma olarak çalışır. Toplu senkronizasyonun premium domain fiyatlarını da otomatik olarak “doğru” hale getireceğini varsaymayın — ayrı kontrol edin.

“Premium domain” ifadesi tek bir kategori gibi kullanılsa da, pratikte birbirinden farklı üç durumu kapsayabilir:

Tür Ne Anlama Gelir
Registry Premium TLD'yi yöneten registry'nin (örneğin .com için Verisign), belirli kısa/değerli isimleri standart fiyatın üzerinde fiyatlandırması. Kayıt anında registry seviyesinde belirlenir.
Aftermarket (İkinci El) Zaten başka bir kişi/şirket tarafından kayıtlı olan, satışa çıkarılmış domainler. Bu, registrar'ın birincil kayıt fiyatlandırmasıyla ilgisizdir; ayrı bir satın alma/devir süreci gerektirir.
Registry Reserved Registry tarafından genel kullanıma kapatılmış, hiç kimsenin kayıt yapamadığı isimler (örneğin kurumsal/yasal nedenlerle ayrılmış isimler).

Bu rehberdeki TLD & Pricing Sync süreci, yalnızca standart kayıt/yenileme/transfer/redemption fiyatlandırmasını kapsar. Registry Premium fiyatlandırması WHMCS'te genellikle ayrı bir “Premium Domain Pricing” mekanizmasıyla yönetilir; aftermarket domainler ise zaten bu sürecin tamamen dışındadır.

Güvenlik

API Key'inizi ortam değişkenlerinde saklayın, kaynak koda gömmeyin.

Mümkünse IP Whitelist kullanarak API çağrılarını güvenilir sunucularla sınırlandırın.

API Key'inizi düzenli aralıklarla yenileyin (rotate edin).

Production ortamında Module Log'daki debug loglamayı kapalı tutun; performansı etkiler ve gereksiz hassas veri biriktirebilir.

Senkronizasyon ve domain işlemlerini sadece yetkili admin hesaplarının tetikleyebildiğinden emin olun.

Kontrol Listeleri

Kurulum Öncesi Kontrol Listesi

WHMCS sürümü 7.8+ (TLD Sync aracı için 7.10+ önerilir)

PHP 7.4+ (8.1 önerilir) ve SOAPClient eklentisi etkin

Reseller ID ve API Key elinizde

Mevcut modül varsa yedek alındı

Kurulum Sonrası Kontrol Listesi

Modül dosyaları doğru dizine yüklendi ve WHMCS tarafında görünüyor

Reseller ID/API Key girildi, bakiye doğru görüntüleniyor

Domain Pricing ekranında ilgili uzantılar için registrar atandı

Registrar TLD Sync ile fiyatlar içe aktarıldı, markup uygulandı

Test siparişiyle kayıt/yenileme/transfer fiyatları doğrulandı

Genel Ayarlar (Domains) ve Domain Sync Settings yapılandırıldı

Bakım (Maintenance) Kontrol Listesi

Fiyat senkronizasyonu düzenli bir takvime bağlandı (örn. ayda bir)

Kur hareketliliği yüksek dönemlerde ek kontrol yapılıyor

Module Log periyodik olarak (sorun şüphesinde) kontrol ediliyor

Modül sürümü güncel tutuluyor

Premium domain fiyatları ayrı olarak gözden geçiriliyor

Sık Sorulan Sorular

WHMCS'te TLD fiyat senkronizasyonu nedir?

WHMCS'in çekirdeğinde gelen, registrar modülünüzden (örneğin Domain Name API) güncel maliyet fiyatlarını çekip, tanımladığınız kâr marjı kuralına göre satış fiyatını toplu olarak hesaplayan ve uygulayan bir araçtır (Utilities > Registrar TLD Sync).

Bu özellik gerçekten otomatik mi?

Hesaplama ve toplu uygulama otomatiktir, ama işlemi başlatmak (Utilities ekranına girip senkronizasyonu tetiklemek) manuel bir adımdır. WHMCS bunu kendiliğinden, belirli bir takvime göre arka planda tekrarlamaz.

TLD Sync ile Domain Sync aynı şey mi?

Hayır. TLD Sync fiyatlandırmayı; Domain Sync ise zaten kayıtlı domainlerin durumunu/bitiş tarihini senkronize eder. Domain Sync, cron üzerinden otomatik çalışır; TLD Sync elle tetiklenir.

Hangi WHMCS sürümü gerekli?

TLD & Pricing Sync aracı WHMCS 7.10 ve sonrasında kullanılabilir; Domain Name API modülü için minimum WHMCS 7.8 önerilir.

Domain Name API modülü bu özelliği destekliyor mu?

Evet. Domain Name API'nin resmî WHMCS kurulum rehberi, Utilities > Registrar TLD Sync ekranında “DomainNameApi”i seçerek toplu fiyat senkronizasyonu yapılabildiğini açıkça belirtiyor.

Kâr marjını nasıl tanımlarım?

Senkronizasyon ekranında markup kuralınızı yüzde veya sabit tutar olarak tanımlayabilir, isterseniz hesaplanan fiyatı belirli bir basamağa (örneğin .95) yuvarlayabilirsiniz.

Maliyetin altında satış yapıp yapmadığımı nasıl anlarım?

TLD & Pricing Sync ekranı, maliyetin altında kalan satırları görsel olarak vurgular; bu sayede zarar ettiğiniz uzantıları hızlıca tespit edebilirsiniz.

Yenileme fiyatı, kayıt fiyatından farklı olabilir mi?

Evet, WHMCS bu iki fiyatı ayrı alanlar olarak tutar; senkronizasyon sırasında her ikisini de kontrol etmeniz gerekir.

Premium domainler bu senkronizasyondan etkilenir mi?

Premium domain fiyatlandırması registry tarafından standart dışı belirlenir ve ayrı bir mekanizmayla yönetilir; toplu TLD senkronizasyonuna güvenmeyin, ayrıca kontrol edin.

Hangi para biriminde fiyat girmeliyim?

Registrar'ınızın maliyet fiyatını tanımladığı para birimi WHMCS kurulumunuzdaki para birimiyle eşleşmeli; eşleşmiyorsa kur dönüşümünü doğru yapılandırmanız gerekir.

Senkronizasyon sırasında Unauthorized hatası alıyorum, ne yapmalıyım?

Bu, fiyatlandırmayla değil kimlik doğrulamayla ilgili bir hatadır. Reseller ID, API Key ve IP Whitelist yapılandırmanızı kontrol edin; ayrıntılı adımlar için ilgili rehberimize bakın.

Invalid API Key hatası fiyat senkronizasyonunu engeller mi?

Evet, çünkü senkronizasyon da diğer tüm API çağrıları gibi geçerli bir Reseller ID ve API Key gerektirir.

Reseller Not Found hatası alıyorum, fiyatlarla mı ilgili?

Hayır, bu da bir kimlik doğrulama hatasıdır; genellikle kullanıcı adı alanına e-posta yazılmasından kaynaklanır.

Senkronizasyonu otomatik bir cron görevine bağlayabilir miyim?

Bu, WHMCS'in standart, dokümante edilmiş davranışının parçası değildir; istiyorsanız bu özel bir geliştirme gerektirir ve modülünüzün/API'nin bunu desteklediğinden bağımsız olarak ek mühendislik işidir.

Modül dosyalarını nereye yüklemeliyim?

WHMCS'in kurulu olduğu dizine, örnek olarak /home/whmcs/public_html altına; .gitignore, README.md ve LICENSE dosyalarını silmeden.

Modül System Settings'te görünmüyor, ne yapmalıyım?

Dosyaların doğru dizine yüklendiğini kontrol edin; yanlış konuma yüklenen modüller WHMCS tarafında hiç görünmez.

WHOIS sorgularını da Domain Name API üzerinden yapabilir miyim?

Evet, Domain Pricing ekranındaki “Lookup Provider” ayarından “DomainNameApi”i seçip hangi uzantılar için kullanılacağını belirleyebilirsiniz.

Senkronizasyon ne kadar sürer?

Uzantı sayısına ve API yanıt süresine bağlı olarak değişir; çok sayıda uzantıda işlem birkaç dakikaya kadar sürebilir.

Eski modül sürümüyle bu özellik çalışır mı?

Çalışmayabilir veya beklenmedik davranabilir; GitHub'daki domainreseller organizasyonundan güncel sürümü kullanmanızı öneririz.

Senkronizasyon hatasını nasıl teşhis ederim?

System Logs > Module Log bölümünden ilgili tarihe tıklayıp istek/yanıt detaylarını inceleyebilirsiniz; gerekirse geçici olarak debug loglamayı açabilirsiniz.

İlgili Kaynaklar

WHMCS Nasıl Kurulur? (Domain Name API Entegrasyonu)

Unauthorized (Yetkisiz) API Erişim Hatası: Sebepleri ve Çözüm Rehberi

Reseller Not Found Hatası ve Açıklaması

Geçiş Sonrası Entegrasyon Rehberi (WHMCS, WiseCP, HostBill, Blesta, ClientExec)

WHMCS'in kendi resmî dokümantasyonu da bu konuda faydalı:

WHMCS Resmî Dokümantasyonu: Registrar TLD Sync

Sonuç

WHMCS'in TLD & Pricing Sync aracı, Domain Name API modülüyle birlikte kullanıldığında, yüzlerce uzantının fiyatını elle tek tek güncellemek zorunda kalmadan, kural tabanlı ve toplu şekilde güncellemenizi sağlar. İşlemi başlatmak elle yapılan bir adımdır, ama hesaplama ve toplu uygulama kısmı gerçekten otomatik ve hızlıdır. Bunu düzenli bir alışkanlık haline getirdiğinizde hem zaman kazanır hem de maliyetin altında satış riskini ortadan kaldırırsınız.

Kurulum sırasında bir sorunla karşılaşırsanız, Module Log'daki detaylı kayıtlar ve destek ekibimiz size yardımcı olmaya hazır.

WHMCS ile Domain Satışını Otomatikleştirin

Bugün ücretsiz bayi hesabınızı oluşturabilir, Domain Name API'nin WHMCS modülüyle birkaç dakika içinde fiyat senkronizasyonunu yapılandırabilir ve yüzlerce uzantıyı tek panelden yönetmeye başlayabilirsiniz.

Ücretsiz bayi hesabı, aktivasyon ücreti veya minimum depozito şartı yok

WHMCS modülü ücretsiz ve hazır, kurulumu dakikalar sürer

Sandbox (Test/OT&E) ortamında riske girmeden test edebilirsiniz

850'den fazla uzantı, tek panelden yönetilebilir

200'den fazla ülkede 40.000'den fazla bayi tarafından kullanılan altyapı

7/24 teknik destek: ticket, telefon ve canlı destek