WHMCS'te Para Birimi ve Fiyat Senkronizasyonu Sorunlarının Çözümü

Kısa Cevap — WHMCS'te para birimi senkronizasyon sorunlarının en yaygın nedeni çalışmayan cron görevleri, güncellenmemiş döviz kurları ve yanlış para birimi kodu/format yapılandırmasıdır. Bu üç noktayı sırayla kontrol etmek sorunların büyük kısmını birkaç dakika içinde çözer.

Kısa Özet — Bu rehberde, WHMCS tabanlı hosting otomasyonlarında sıkça karşılaşılan para birimi senkronizasyon hataları, döviz kuru güncellenmeme problemleri ve domain fiyatlarının yanlış yansıması gibi teknik sorunların kök nedenleri incelenmektedir. Sistem altyapısının çalışma mantığından cron işlevlerine, veritabanı kontrollerinden DomainNameAPI modül ayarlarına; hata mesajı bazlı tanılamadan rakip panel karşılaştırmasına kadar tüm çözüm adımları pratik tablolar, karar ağaçları ve saha deneyimi notlarıyla ele alınmıştır.

DomainNameAPI Teknik Ekibinin Gözlemi

Son 12 ayda DomainNameAPI destek ekibine ulaşan teknik taleplerin yaklaşık %35'i para birimi ve fiyat senkronizasyonu kaynaklıdır. Bu taleplerin büyük kısmı, bu rehberde anlatılan üç kontrolü (cron, kur, para birimi kodu) yapılmadan açılmış destek talepleridir.

Base Currency (Ana Para Birimi)

Sisteminizin temel aldığı, tüm muhasebe ve maliyet hesaplamalarının merkezinde yer alan para birimidir. Genellikle şirketinizin yasal olarak bağlı olduğu ülkenin para birimi (TRY) ya da global domain maliyetlerini doğrudan karşıladığınız para birimi (USD) ana para birimi olarak seçilir.

Kritik Not — Kritik Not: WHMCS'te Base Currency için döviz kuru her zaman 1.00000 olarak kabul edilir ve bu değer değiştirilemez.

Additional Currency (Ek Para Birimleri)

Müşterilerinize sitenizin ön yüzünde sunduğunuz alternatif ödeme para birimleridir — örneğin Türk Lirası, Euro veya Sterlin. Bu para birimlerinin kurları düzenli olarak güncellenmelidir.

Exchange Rates ve Auto Update Rates

WHMCS, ek para birimlerinin ana para birimine olan oranını Exchange Rate değeri üzerinden hesaplar. Eğer sistem ayarlarında Auto Update Rates aktifse, WHMCS her gün otomatik olarak kur sağlayıcıları üzerinden bu oranları çeker ve günceller. Ancak cron çalışmaması, API erişiminin kesilmesi, güvenlik duvarı engelleri veya manuel değişiklikler nedeniyle bu güncellemeler durabilir ve fiyatlar yanlış hesaplanmaya başlar.

Not — Not: Setup > Payments > Currencies menüsü gösterilmeli; Base Currency satırı, "Update Rates" butonu ve otomatik kur güncelleme onay kutusu belirgin şekilde işaretlenmelidir. Teknik detay: WHMCS'in yeni Twenty-One/Alphanumeric tema arayüzünde bu menüye Configuration (Setup) > System Settings > Currencies üzerinden ulaşılır; eski Blend temasında ise menü yapısı Setup > Payments > Currencies şeklindeydi — ekran görüntüsü alırken kullandığınız WHMCS sürümünün tema yapısına göre doğru menü adını kullanın.

Registrar Modülü

DomainNameAPI gibi ana sağlayıcıların API entegrasyonunu sağlayan köprü yazılımı; güncel maliyetleri ve TLD listesini WHMCS'e aktarır.

Domain Pricing

Her TLD için tanımlanan kayıt, yenileme ve transfer fiyat matrisi.

Currency Conversion

Sağlayıcı fiyatları USD ise ve domain TRY olarak satılıyorsa, WHMCS tanımlı Exchange Rate değerini alıp fiyat tablosundaki oranla çarparak son kullanıcı fiyatını hesaplar.

Kâr Marjı

Admin panelinde tanımlanan yüzde veya sabit tutar.

API Üzerinden Maliyet Çekme

Modül, bayi hesabınıza tanımlı özel ve indirimli fiyatları API aracılığıyla sorgular.

Kâr Marjı Ekleme

Admin panelinde belirlediğiniz yüzde veya sabit tutardaki kâr marjını net maliyetin üzerine ekler.

Para Birimi Eşleme

API'den gelen fiyat birimi WHMCS'teki para birimleriyle karşılaştırılır; eşleşme yoksa döviz kuru mekanizması devreye girer ve sonuç tblpricing tablosuna yazılır.

DomainNameAPI Teknik Ekibinin Gözlemi

Saha deneyimimize göre en sık karşılaştığımız problem, çalışmayan veya yanlış zamanlanmış cron görevleridir. Destek taleplerinin önemli bir kısmı, modül ayarlarında bir hata olmadığı halde sadece cron'un günlerce tetiklenmemiş olmasından kaynaklanır.

"Currency Update Failed"

Bu mesaj, WHMCS'in döviz kuru güncelleme görevini tetiklediğini ancak dış kur servisinden veri alamadığını gösterir. En sık sebep, sunucunun giden (outbound) bağlantılarının güvenlik duvarı tarafından engellenmesi veya PHP'nin curl/allow_url_fopen ayarlarının kapalı olmasıdır.

"Exchange Rates Not Updated"

Kur güncelleme görevi çalışmış ama veritabanına yazma işlemi başarısız olmuş olabilir. tblcurrencies tablosundaki ilgili satırın kilitli (locked) olup olmadığını ve veritabanı kullanıcı izinlerini kontrol edin.

"Cron Has Not Run in the Last 24 Hours"

Bu, WHMCS'in en kritik sistem uyarılarından biridir. Sunucunuzdaki cron job tanımının doğru PHP yoluna işaret ettiğinden ve son çalışma zaman damgasının güncel olduğundan emin olun. Bu uyarı varken hem kur hem domain fiyat senkronizasyonu tamamen durur.

"Module Not Found"

WHMCS, DomainNameAPI modül dosyalarını /modules/registrars/domainnameapi/ dizininde bulamadığında bu hatayı verir. Dosyaların eksiksiz yüklendiğini, dizin/dosya izinlerinin (644/755) doğru olduğunu ve modülün admin panelinden aktive edildiğini doğrulayın.

"API Authentication Failed"

Bu hata, gönderilen API kimlik bilgilerinin DomainNameAPI tarafında doğrulanamadığını gösterir. En sık sebepler: yanlış/eski API anahtarı, sunucu IP'sinin yetkilendirme listesinde olmaması veya hesap bakiyesinin/durumunun işlemi engellemesidir.

"Invalid Currency Code"

WHMCS, ISO 4217 standardı dışında bir para birimi kodu (örneğin TRY yerine TL) gönderildiğinde bu hatayı üretir. Para birimi kodunun mutlaka 3 haneli uluslararası standartta (USD, EUR, TRY) girildiğini kontrol edin; sembol (₺, $ gibi) ayrı bir alandır ve kodu etkilemez.

Kur Güncellenmiyor (Genel Senaryo)

WHMCS yerleşik olarak merkez bankası kaynaklarından kur çeker. Sunucu bazlı bağlantı sorunları, firewall engelleri veya API değişiklikleri nedeniyle güncelleme yapılamazsa sistem eski kurda kalır.

Fiyatlar Yanlış Görünüyor / TLD Fiyatları Eşleşmiyor

Müşteri sepetine bir domain eklediğinde beklenenden çok yüksek veya çok düşük bir fiyat görmesi durumudur. Genellikle ondalık basamak hatalarından veya para birimi kodu/sembolünün yanlış yapılandırılmasından kaynaklanır.

Manuel Fiyatların Üzerine Yazılması

Yönetici olarak bazı stratejik TLD'lerde fiyatları elle sabitlemiş olabilirsiniz. Ancak cron veya otomatik senkronizasyon çalıştığında bu manuel ayarlar sıfırlanıp modülün getirdiği standart fiyatlar üzerine yazılabilir.

USD Doğru Fakat TRY Yanlış (Çapraz Kur Hatası)

USD para birimi sorunsuz işlerken TRY seçildiğinde fiyatların mantıksız bir hal almasıdır. Genellikle TRY'nin döviz kuru değerinin güncellenmemesinden veya para birimi kodunun uluslararası standart olan TRY yerine yanlış girilmesinden kaynaklanır.

1) USD (Base Currency) fiyatı doğru mu?

• Hayır → Registrar (DomainNameAPI) tarafındaki maliyet ve modül senkronunu kontrol edin.
• Evet → 2. adıma geçin.

2) Sadece TRY mi yanlış, yoksa tüm para birimleri mi?

• Sadece TRY yanlış → TRY için tanımlı Exchange Rate değerini ve para birimi kodunu (TRY/TL karışıklığı) kontrol edin.
• Tüm para birimleri yanlış → Cron durumunu ve tblpricing tablosundaki kayıtları kontrol edin.

3) Sorun hâlâ çözülmediyse → Module Log üzerinden DomainNameAPI'ye giden son isteği (request/response) inceleyin.

Cron Durumu Kontrolü

Admin panelinizde System Status veya Automation Status alanına giderek cron işleyişini inceleyin. Eğer sistem "Cron has not run in the last 24 hours" uyarısı veriyorsa, kur güncellemeleriniz ve domain fiyat senkronizasyonunuz tamamen durmuş demektir. Sunucu kontrol panelinizden cron komutunun doğru PHP versiyonuyla tetiklendiğinden emin olun.

Activity Log

Utilities > Logs > Activity Log yolunu izleyin; "Currency Exchange Rates Updated" satırını arayın.

Module Log

Utilities > Logs > Module Log alanına gidin, kapalıysa "Enable Debug Logging" ile açın. DomainNameAPI'ye gönderilen istek ve dönen fiyat listesinin ham verilerini burada görebilirsiniz. "Auth Error" veya "IP Not Allowed" dönütü varsa sorun API yetkilendirmesindedir.

Not — Not: Üstte Activity Log içindeki "Cron Job: Running Currency Update" satırı, altta Module Log içindeki DomainNameAPI veri alışverişi ekranı gösterilmelidir.

Önemli Uyarı — Önemli Uyarı: Veritabanı üzerinde doğrudan işlem yapmadan önce mutlaka tam bir yedek alın. Yanlış bir işlem tüm faturalandırma ve fiyatlandırma yapınızı bozabilir.

tblcurrencies

Sisteminizde tanımlı tüm para birimlerini ve kur oranlarını (rate sütunu) tutar. Bir para biriminin kuru 0.00000 olarak kalmışsa, o para birimindeki tüm fiyatlar geçersiz görünür.

tblpricing

WHMCS'teki tüm fiyat matrisinin merkezidir; type sütununda domainregister, domaintransfer, domainrenew gibi değerler, currency sütununda ise ilgili para birimi ID'si yer alır.

Base Currency Uyumu

DomainNameAPI bayi hesabınızdaki ana para birimi ile WHMCS'teki Base Currency'nin aynı olması (tercihen USD), dönüştürme adımlarını azaltarak çapraz kur farklarından doğan yuvarlama hatalarını ortadan kaldırır.

Cron Zamanlaması Senkronizasyonu

WHMCS genel kur güncelleme cron'u ile domain fiyat senkronizasyon cron'unu aynı saate denk getirmeyin; önce kurlar güncellensin, ardından fiyat senkronu çalışsın.

Kâr Marjı Stratejisi

Fiyatların her senkronizasyonda sıfırlanmasını istemiyorsanız sabit fiyat girmek yerine yüzde tabanlı kâr marjı özelliğini kullanın.

DomainNameAPI Teknik Ekibinin Gözlemi

Birden fazla para biriminde satış yapan bayilerimizin çoğu, Base Currency'yi USD'de sabitleyip yalnızca Additional Currency kurlarını otomatik güncellemeyi tercih ediyor. Bu yaklaşım, çapraz kur hesaplama hatalarını gözlemlediğimiz vakaların büyük kısmında tamamen ortadan kaldırıyor.

1. WHMCS'te otomatik kur güncellemesi aktif olmasına rağmen kurlar neden güncellenmiyor?

Bu durumun en yaygın sebebi, WHMCS'in kur verilerini çektiği harici servislere sunucunuzun erişememesidir. Güvenlik duvarı giden bağlantıları engelliyor olabilir ya da PHP'nin allow_url_fopen fonksiyonu kapalıdır. Ayrıca cron sisteminin düzgün çalışmaması da güncellemeyi engeller. Automation Status alanından cron'un hatasız çalıştığını doğrulayın ve sunucu yöneticinizden harici servislere erişim izni talep edin.

2. Domain fiyatları admin panelinde doğru ancak web sitesi ön yüzünde neden yanlış çıkıyor?

Bu sorun genellikle tarayıcı ve sistem önbelleğinden kaynaklanır. Fiyat güncellemelerinden sonra Utilities > System > Clear Templates Cache seçeneğini kullanarak önbelleği temizleyin. Ayrıca ziyaretçinin sitenizi hangi para birimiyle görüntülediğini kontrol edin; kur dönüşüm oranı hatalıysa doğru fiyat yanlış katsayıyla çarpılarak gösterilebilir.

3. DomainNameAPI modülü senkronizasyon yaptığında manuel girdiğim kampanya fiyatları silinir mi?

Evet, modülün otomatik fiyat senkronizasyonunu genel olarak aktif ettiyseniz ve belirli TLD'leri hariç tutmadıysanız, cron her çalıştığında ilgili TLD satırlarını günceller ve manuel girdiğiniz fiyatların üzerine yazar. Kampanya yapacağınız uzantıları senkronizasyon listesinden çıkarmanız veya kâr marjı ayarlarını o uzantıya özel optimize etmeniz gerekir.

4. WHMCS para birimi ayarlarında para birimi kodu neden bu kadar önemli?

WHMCS, kur sağlayıcılardan veri çekerken ISO 4217 standardındaki 3 haneli kodları kullanır. Para birimi kodunu standart dışı girerseniz sistem bunu tanımaz ve kur güncelleme servisinden hata döner. Kod mutlaka TRY, USD, EUR gibi 3 haneli standartta girilmelidir; sembol kısmı tamamen görseldir ve istenildiği gibi ayarlanabilir.

5. Domain fiyat senkronizasyonunda "Module Not Found" veya API hatası alıyorum, ne yapmalıyım?

Bu hata WHMCS sisteminizin DomainNameAPI sunucularıyla güvenli bir bağ kuramadığını gösterir. Önce, bayi panelinize girip sunucunuzun IP adresinin API erişim izni listesine eklenip eklenmediğini kontrol edin. Ardından modül dosyalarının doğru dizine ve doğru izinlerle yüklendiğinden emin olun.

6. Sistemimde sadece USD ve TRY var. Domain maliyetleri USD iken TRY fiyatlar nasıl belirleniyor?

WHMCS, domain fiyat matrisinde TRY alanını boş bırakırsanız veya otomatik hesaplama talimatı verirseniz, USD fiyatını alıp tblcurrencies tablosundaki güncel TRY kuruyla çarparak son kullanıcı fiyatını hesaplar. Bu yüzden kurun güncelliği hayati önem taşır.

7. WHMCS'te Base Currency sonradan değiştirilebilir mi?

Teknik olarak veritabanı üzerinden değiştirilebilir ancak bu işlem son derece risklidir ve kesinlikle tavsiye edilmez. Base Currency değiştiğinde geçmiş faturalar, ödemeler ve raporlar eski para birimi katsayısıyla kalır ve finansal veriler birbirine karışır. Bu seçim şirket yapılandırmasının en başında doğru yapılmalıdır.

8. Virgülden sonraki basamakların (ondalık hane) fiyat senkronizasyonuna etkisi nedir?

WHMCS'te Decimal Places değeri genellikle 2 olarak ayarlanırken domain sağlayıcılarının API'leri 4 veya daha fazla basamakla çalışabilir. Yuvarlama ayarları veya ondalık işaretleri hatalı yapılandırılmışsa kur dönüşümlerinde cent bazlı kayıplar oluşabilir veya fiyatlar yanlış algılanabilir.

9. Activity Log'da "Cron Job: Currency Update Failed" hatası görüyorum, çözümü nedir?

Bu hata cron'un kur güncelleme fonksiyonunu tetiklediğini ancak dış kaynaktan veri alamadığını gösterir. Öncelikle WHMCS'in güncel sürümünü kullandığınızdan emin olun; eski sürümler artık geçerli olmayan kur servis adreslerini kullanıyor olabilir. Sürüm güncelse, sunucunuzun curl kütüphanesinin ve SSL bağlantısının sorunsuz çalıştığını sunucu firmanızla doğrulayın.

10. DomainNameAPI entegrasyonuyla bayi ağımı genişletirken fiyat senkronizasyonunu nasıl kullanabilirim?

Kendi alt bayilerinizi yönetiyorsanız, DomainNameAPI'den aldığınız esnek fiyat yapısını doğrudan alt bayilerinize yansıtabilirsiniz. Farklı müşteri grupları tanımlayarak her grup için farklı kâr marjları uygulayabilir ve tüm bayi ağınızın fiyat senkronizasyonunu tek merkezden otomatize edebilirsiniz.

11. WHMCS Twenty-One/Alphanumeric ve Blend temalarında para birimi menüsü farklı mı?

Menünün işlevi aynıdır ancak yolu temaya göre değişir. Yeni Twenty-One/Alphanumeric arayüzünde Configuration (Setup) > System Settings > Currencies üzerinden ulaşılırken, eski Blend temasında Setup > Payments > Currencies yolu kullanılır. Ekran görüntülü dokümantasyon hazırlarken kullandığınız sürümün tema yapısını belirtmeniz kafa karışıklığını önler.

12. Birden fazla registrar modülü (DomainNameAPI + başka bir sağlayıcı) aynı anda kullanılırsa fiyat çakışması olur mu?

Evet, aynı TLD için iki farklı registrar modülü aktifse WHMCS hangi modülün "birincil" (primary) olduğuna göre fiyatı çeker. Eğer her iki modül de o TLD için fiyat senkronizasyonu yapıyorsa, son çalışan cron görevi fiyatı belirler. Çakışmayı önlemek için her TLD'yi yalnızca bir registrar modülüne bağlı tutmanız önerilir.

13. Test ortamında (sandbox) fiyat senkronizasyonu canlı ortamı etkiler mi?

Hayır, DomainNameAPI'nin test ve canlı ortamları birbirinden tamamen ayrıdır; ayrı API anahtarları ve ayrı bakiyeler kullanır. Ancak modül ayarlarında yanlışlıkla canlı API anahtarı yerine test anahtarı girilmişse, fiyatlar ve domain işlemleri canlı ortamda başarısız olur. Bu, "API Authentication Failed" hatasının sık görülen bir sebebidir.

14. Fiyat senkronizasyonu sırasında bazı TLD'ler neden listeye hiç gelmiyor?

Bunun en yaygın sebebi, ilgili TLD'nin DomainNameAPI bayi hesabınızda henüz aktif/satışa açık olmamasıdır. Reseller panelinizden o uzantının durumunu kontrol edin; aktif değilse WHMCS senkronizasyonu o TLD'yi listeye dahil etmez.

15. Yenileme (renewal) fiyatları neden kayıt (register) fiyatından farklı senkronize oluyor?

DomainNameAPI'den gelen fiyat akışı kayıt, yenileme ve transfer için ayrı ayrı maliyet bilgisi taşır; bu üç işlem türü farklı toptan fiyatlandırmaya sahip olabilir. WHMCS bu üç değeri Domain Pricing ekranında ayrı sütunlarda tutar; birinin senkronize olup diğerinin olmaması genellikle modül ayarlarındaki seçili işlem türleriyle ilgilidir.

16. Kur güncellemesi yapıldıktan sonra mevcut açık siparişlerin (pending orders) fiyatı değişir mi?

Hayır. Bir sipariş oluşturulduğu andaki fiyat ve kur bilgisi o sipariş kaydına sabitlenir. Sonraki kur güncellemeleri yalnızca yeni oluşturulacak siparişleri ve henüz sepete eklenmemiş ürünlerin görüntülenen fiyatını etkiler.

17. Para birimi senkronizasyon sorunlarını otomatik olarak izlemek mümkün mü?

Evet. WHMCS'in Activity Log ve Module Log kayıtlarını harici bir izleme aracına (örneğin bir log-monitoring servisine) yönlendirerek "Currency Update Failed" veya "Cron Has Not Run" gibi ifadeleri içeren satırlar için otomatik uyarı kurabilirsiniz. Bu, sorun büyümeden önce haberdar olmanızı sağlar.

18. WHMCS dışında bir muhasebe/ERP sistemiyle entegre çalışıyorsam para birimi tutarsızlığı oluşur mu?

Eğer harici sistem kendi kur kaynağını kullanıyorsa ve WHMCS'teki kurla senkronize değilse, raporlama tarafında küçük tutarsızlıklar görülebilir. Bu durumda her iki sistemin de aynı kur kaynağını (örneğin aynı merkez bankası API'sini) kullanmasını sağlamak tutarsızlığı ortadan kaldırır.

19. Domain fiyatlarını yalnızca belirli müşteri gruplarına özel farklı kurla göstermek mümkün mü?

WHMCS'in standart yapısında para birimi kuru tüm müşteriler için aynıdır; gruplara özel kur tanımlamak yerleşik bir özellik değildir. Bunun için genellikle özel fiyatlandırma kuralları (Pricing Rules) veya üçüncü parti eklentiler kullanılır; DomainNameAPI modülü kâr marjı ayarı bu noktada gruplar arası farklılaştırma için kullanılabilecek en pratik yöntemdir.

20. Fiyat senkronizasyon sorunlarını önlemek için önerilen kontrol periyodu nedir?

Günlük cron çalışmasının yanında, haftalık olarak Module Log'u manuel gözden geçirmek ve ayda bir kez tüm TLD fiyat matrisini örnek siparişlerle test etmek, sorunların büyümeden tespit edilmesini sağlar. Yüksek hacimli bayiler için bu kontrolü otomatik uyarı sistemine bağlamak daha verimlidir (bkz. Soru 17).

Domain Satışlarınızı Tam Otomasyonla Yönetin

Fiyat senkronizasyon hatalarıyla vakit kaybetmeyi bırakın. DomainNameAPI WHMCS modülü ile dünya genelindeki yüzlerce TLD'nin güncel fiyatlarını, döviz kurlarını ve bayi kâr marjlarınızı tamamen otomatik olarak yönetin.

Ücretsiz Domain Reseller programımıza katılarak en uygun maliyetlerle domain sağlamaya başlayın; gelişmiş teknik dokümantasyonumuz ve kesintisiz API desteğimizle işinizi büyütün.