Xboard ve V2Board için kripto ödemeler
Xboard ve V2Board VPN ve proxy panelleri için bir ödeme eklentisi. Müşteri ödeme adımında SnapEX Pay sayfasına gider, USDT ile TRC20, ERC20, BEP20, Solana, TON veya başka bir ağda (ya da SnapEX'in bu tutar için sunduğu başka bir yöntemle) öder ve sipariş imzalı bir webhook'un ardından otomatik olarak açılır. Cüzdan, node ya da kendi sunucunuzda ödeme geçidi çalıştırmanız gerekmez; para SnapEX Pay üye işyeri bakiyenize düşer.
Ücretsiz. Sürüm 1.2.0.
Ne yapar
- Xboard için yerel eklenti (yönetim panelindeki eklenti yöneticisinden kurulur) ve V2Board ile eski Xboard sürümleri için kopyalayıp kullanabileceğiniz hazır
app/Payments/SnapexPay.phpsınıfı. - Tutarlar doğru birimde: paneldeki sent cinsinden toplamlar ondalıklı USD tutarı olarak gönderilir; USD dışında satış yapan mağazalar için isteğe bağlı bir kur tanımlanabilir.
- İmzalı webhook'lar (HMAC-SHA256, 5 dakikalık zaman aralığı); fatura SnapEX Pay API'sinden yeniden okunur ve sipariş yalnızca durum paid olduğunda ödenmiş sayılır.
- Pay düğmesine tekrar tıklanırsa aynı fatura kullanılır; süresi dolmuşsa aynı sipariş için yeni bir fatura açılır. Yöntem canlı moddayken test faturaları hiçbir zaman sipariş açamaz.
- Ödeme süresi, panelin kendi sipariş zaman aşımından (Xboard 2 saat, V2Board 30 dakika) asla uzun olmaz. Sade PHP ve cURL, ek bağımlılık yok.
Kurulum
- Xboard: yönetim paneli → Plugins → indirdiğiniz ZIP dosyasını yükleyin → Install → Enable ile "SnapEX Pay" eklentisini etkinleştirin. (Ya da arşivi açıp klasörü panele
plugins/Snapexpay/olarak koyun — adda büyük/küçük harf önemlidir — ve ardından Plugins bölümünden kurun.) - V2Board veya eski Xboard: arşivdeki
app/Payments/SnapexPay.phpdosyasını panele kopyalayın ve OPcache kullanıyorsanız PHP-FPM ya da Octane servisini yeniden başlatın; V2Board'da Site URL (app_url) alanının dolu olduğundan emin olun. - Payment configuration → Add payment method → gateway SnapexPay. SnapEX Pay panelinden aldığınız API anahtarını (yetkiler:
invoices.read,invoices.write) yapıştırın. - Panelin bu yöntem için gösterdiği notify URL'sini kopyalayın, SnapEX Pay panelinde (“Geliştiriciler”) webhook URL'si olarak ayarlayın ve
whsec_…gizli anahtarını (yalnızca bir kez, URL ilk kaydedildiğinde gösterilir) Webhook secret alanına yapıştırın. - Fiyatlar USD değilse "USD per 1 shop currency" alanını doldurun (örneğin CNY için
0.14). Kaydedin ve bir ödemeyi test edin.
Ayarlar
| API key | SnapEX Pay panelinin “Geliştiriciler” bölümünden; invoices.read ve invoices.write yetkileriyle. |
|---|---|
| Webhook secret | Webhook endpoint'inin whsec_… gizli anahtarı. Geçerli bir imza olmadan hiçbir sipariş ödenmiş sayılmaz. |
| Network fee paid by | merchant: müşteri tam olarak sipariş tutarını öder, komisyon size gelen tutardan kesilir. customer: SnapEX Pay komisyonu ve ağ ücreti tutarın üzerine eklenir. |
| Payment window, minutes | Xboard'da varsayılan 60 (en fazla 120), V2Board'da varsayılan 20 (en fazla 30) — panellerin kendi sipariş zaman aşımlarından uzun olamaz. |
| USD per 1 shop currency | USD fiyatlar için 1; örneğin CNY için 0.14. |
| 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. |
Sorular
V2Board ile çalışır mı?
Evet. Xboard için yerel bir eklenti var; V2Board ve eski Xboard sürümleri aynı ayarlarla hazır app/Payments/SnapexPay.php sınıfını kullanır.
Fiyatlarım CNY veya başka bir para biriminde.
"USD per 1 shop currency" alanını doldurun: tutar total / 100 × usd_rate olarak hesaplanır, örneğin CNY için 0.14.
Müşteri Pay düğmesine iki kez tıklarsa ne olur?
Aynı fatura yeniden kullanılır; süresi dolmuşsa aynı sipariş için yeni bir fatura açılır.
Ödeme süresi neden sınırlı?
Xboard ödenmemiş siparişleri 2 saat, V2Board ise 30 dakika sonra iptal eder; bu yüzden süre bu sınırı aşamaz.
Neden HTTPS gerekiyor?
SnapEX Pay webhook'ları yalnızca herkese açık HTTPS URL'lerine gönderir ve sipariş webhook ile açılır.
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.