WHMCS için kripto ödemeler
WHMCS faturalarında kripto ile ödeme alın. Müşteri Pay Now düğmesine basar, SnapEX Pay sayfasında TRON, Ethereum, BSC ve diğer ağlarda USDT ile ya da USDT'ye çevrilen diğer kripto paralarla öder; fatura WHMCS'te otomatik ödendi olarak işaretlenir.
Ücretsiz. Sürüm 1.1.0.
Ne yapar
- Cüzdan ya da node çalıştırmanız gerekmez: para SnapEX Pay üye işyeri bakiyenize düşer.
- Faturanın ödendi olarak işaretlenmesinin birbirinden bağımsız üç yolu var: imzalı webhook, müşterinin ödeme sayfasından geri dönmesi ve WHMCS cron her çalıştığında yapılan arka plan kontrolü (bekleyen her ödeme en fazla 10 dakikada bir, 5 gün boyunca). Kaybolan bir webhook yüzünden ödenmiş bir fatura asla ödenmemiş kalmaz ve bir ödeme asla iki kez eklenmez.
- Çok para birimli WHMCS: Convert To For Processing ayarı USD olduğunda faturalar yine müşterinin para biriminde kaydedilir.
- Kısmi ödemeler asla otomatik olarak uygulanmaz: incelemeniz için Gateway Log'a düşer. Webhook kuruluysa SnapEX Pay faturası kapandıktan sonra gelen para da oraya kaydedilir.
- Test modu: test faturaları gerçek para olmadan kendiliğinden onaylanır; mod açıkken Pay düğmesini yalnızca giriş yapmış yöneticiler görür, diğer müşteriler bunun yerine “test modu” notunu görür.
Kurulum
- Arşivin içeriğini yolları koruyarak WHMCS kök klasörüne yükleyin:
modules/gateways/snapexpay.php,modules/gateways/snapexpay/,modules/gateways/callback/snapexpay.php,includes/hooks/snapexpay.php. - WHMCS yönetim panelinde System Settings → Payment Gateways → All Payment Gateways sayfasını açın ve SnapEX Pay (Crypto) ödeme geçidini etkinleştirin.
- SnapEX Pay üye işyeri panelinde
invoices.readveinvoices.writeyetkilerine sahip bir API anahtarı oluşturun ve API key alanına yapıştırın. - Webhook (önerilir): panelde webhook URL'sini
https://<your WHMCS>/modules/gateways/callback/snapexpay.phpolarak ayarlayın (tam adres WHMCS'te alanın altında gösterilir) vewhsec_…gizli anahtarını Webhook secret alanına yapıştırın. - WHMCS para biriminiz USD değilse Convert To For Processing ayarını USD yapın. Faturalar yine müşterinin para biriminde kaydedilir.
- Test mode seçeneğini açın, ödenmemiş bir faturayı yönetici olarak açın, SnapEX Pay sayfasında test yöntemiyle ödeyin ve faturanın Paid durumuna geçtiğini kontrol edin. Ardından test modunu kapatın.
Ayarlar
| API key | SnapEX Pay panelinden. |
|---|---|
| Webhook secret | Panelin webhook ayarlarındaki whsec_… değeri. Bu alan boşken de modül dönüş sayfası ve cron üzerinden çalışmaya devam eder. |
| Network fee paid by | Merchant: müşteri tam olarak fatura tutarını öder, komisyon size gelen tutardan düşülür. Client: SnapEX Pay komisyonu ve ağ ücreti tutarın üzerine eklenir. |
| Payment window, minutes | Ödeme sayfasının ne kadar süre geçerli kalacağı (1–1440, varsayılan 60). Daha sonra Pay Now düğmesine yeniden basıldığında yeni bir sayfa açılır. |
| Test mode | Test faturaları; mod açıkken Pay düğmesini yalnızca yöneticiler görür. Test modu kapatıldıktan sonra test ödemeleri yok sayılır. |
| Partner ID | İsteğe bağlı: modülü kuran entegratörün Partner ID'si (SnapEX Pay referans programı). Modülü kendiniz kurduysanız boş bırakın. |
| API URL | Olduğu gibi bırakın. |
Sorular
Webhook ulaşmazsa ne olur?
Fatura yine de ödendi olarak işaretlenir: modül ödemeyi müşteri ödeme sayfasından döndüğünde ve WHMCS cron her çalıştığında da kontrol eder (bekleyen her ödeme en fazla 10 dakikada bir, 5 gün boyunca). Bir ödeme asla iki kez eklenmez.
WHMCS para birimim USD değil. Çalışır mı?
Evet. Ödeme geçidi ayarlarında Convert To For Processing ayarını USD yapın; faturalar yine müşterinin para biriminde kaydedilir.
Müşteri fatura tutarından az gönderirse ne olur?
Müşteri eksiği süresi içinde tamamlamazsa otomatik olarak hiçbir şey eklenmez. Gateway Log'a alınan tutarla birlikte “Partial payment — review and apply manually” kaydı düşer.
Para SnapEX Pay faturası kapandıktan sonra gelirse ne olur?
WHMCS'te otomatik olarak uygulanmaz. Webhook kuruluysa Gateway Log'a bir kayıt düşer; para SnapEX Pay bakiyenizdedir.
Gerçek para olmadan test edebilir miyim?
Evet. Test mode seçeneğini açın: test faturaları kendiliğinden onaylanır; mod açıkken Pay düğmesini yalnızca giriş yapmış yöneticiler görür.
Modülün ne yaptığını nerede görebilirim?
WHMCS'te Billing → Gateway Log bölümünde. Bir ödemenin işlem ID'si SnapEX Pay fatura ID'sidir (INV-…).
Diğer entegrasyonlar
Kripto ile ödeme almaya hazır mısınız?
Üye işyeri hesabı oluşturun, API anahtarı alın ve modülü bağlayın. Ödeme başına %1 komisyon, aylık ücret yok.