Blesta için kripto ödemeler
Blesta faturalarında kripto ile ödeme alın. SnapEX Pay bir non-merchant ödeme geçididir: müşteri SnapEX Pay (Crypto) yöntemini seçer, SnapEX Pay sayfasında TRON, Ethereum, BSC ve diğer ağlarda USDT ile ya da USDT'ye çevrilen diğer kripto paralarla öder; ödeme Blesta'da otomatik olarak kaydedilir ve faturalara uygulanır.
Ücretsiz. Sürüm 1.0.0.
Ne yapar
- Cüzdan ya da node çalıştırmanız gerekmez: para SnapEX Pay üye işyeri bakiyenize düşer.
- Ödeme, imzalı webhook ile ya da müşteri “ödeme alındı” sayfasına döner dönmez, hangisi önce olursa, kaydedilir. Her iki durumda da fatura önce SnapEX Pay API'sinden yeniden okunur: yalnızca webhook gövdesine dayanarak hiçbir şey ödendi olarak işaretlenmez ve bir ödeme asla iki kez kaydedilmez.
- Faturalar her para biriminde olabilir: USD dışındaki tutarlar Blesta'nın zaten tuttuğu döviz kurlarıyla USD'ye çevrilir ve işlem fatura para biriminde kaydedilir.
- Kısmi ödemeler asla otomatik olarak uygulanmaz: incelemeniz için bekleyen bir işlem olarak kaydedilir.
- Test modu: test faturaları gerçek para olmadan kendiliğinden onaylanır; mod açıkken düğmeyi yalnızca müşteri olarak giriş yapmış personel görür, diğer müşterilerden başka bir ödeme yöntemi seçmeleri istenir.
Kurulum
- Arşivin içeriğini
components/gateways/nonmerchant/snapex_pay/yolunu koruyarak Blesta kök klasörüne yükleyin. - Blesta yönetim panelinde Settings → Payment Gateways → Available sayfasını açın, SnapEX Pay (Crypto) satırını bulun ve Install düğmesine basın. Kurulum tek bir tablo oluşturur:
snapex_pay_invoices. - 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 (zorunlu): panelde
https://<your Blesta>/callback/gw/<company id>/snapex_pay/URL'siyle bir webhook ekleyin (tam adres ödeme geçidi ayarlarında gösterilir) vewhsec_…gizli anahtarını Webhook secret alanına yapıştırın. Blesta'da ödeme geçitleri için cron yoktur; müşteri siteye geri dönmediğinde ödemeler webhook ile gelir. - Faturalarınız USD cinsinden değilse Settings → Company → Currencies altında USD'yi bir döviz kuruyla ekleyin (ya da kurları Blesta'nın otomatik olarak güncellemesine izin verin). Ödeme geçidinin sunulacağı para birimlerini işaretleyin.
- Test mode seçeneğini açın, yönetim panelinden bir müşteri olarak müşteri alanına giriş yapın, SnapEX Pay sayfasında test yöntemiyle bir fatura ödeyin ve faturanın ödendiğini kontrol edin. Ardından test modunu kapatın.
Ayarlar
| API key | SnapEX Pay panelinden. Şifrelenmiş olarak saklanır. |
|---|---|
| Webhook secret | Panelin webhook ayarlarındaki whsec_… değeri. Zorunlu. Şifrelenmiş olarak saklanır. |
| Network fee paid by | Merchant: müşteri tam olarak fatura tutarını öder. Client: komisyon 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 yeniden ödemeye geçildiğinde yeni bir sayfa açılır. |
| Test mode | Test faturaları; mod açıkken düğmeyi yalnızca personel 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 neden zorunlu?
Blesta'da ödeme geçitleri için cron yoktur. Müşteri ödeme yapıp siteye geri dönmezse ödeme Blesta'ya imzalı webhook ile ulaşır. Müşteri geri dönerse ödeme hemen kaydedilir ve asla iki kez kaydedilmez.
Faturalarım USD cinsinden değil. Çalışır mı?
Evet. Settings → Company → Currencies altında USD'yi bir döviz kuruyla ekleyin. Tutarlar Blesta'nın kurlarıyla çevrilir ve işlem fatura para biriminde kaydedilir.
Bir fatura ödendiğinde Blesta'da ne görünür?
Fatura para biriminde, ödenen faturalara uygulanmış onaylı bir işlem. İşlem ID'si SnapEX Pay fatura ID'sidir (INV-…) ve müşteri Blesta'nın olağan “ödeme alındı” e-postasını alır.
Müşteri fatura tutarından az gönderirse ne olur?
Müşteri eksiği süresi içinde tamamlamazsa, mesajında alınan tutarın yazdığı bekleyen bir işlem kaydedilir ve faturaya uygulanmaz. Bu işlemi müşterinin işlemleri altında inceleyin.
Ödeme sayfasının süresi ödeme yapılmadan dolarsa ne olur?
Hiçbir şey kaydedilmez. Para fatura kapandıktan sonra gelirse ödeme geçidi loguna bir kayıt düşer; para SnapEX Pay bakiyenizdedir.
Modülün ne yaptığını nerede görebilirim?
Blesta'da Tools → Logs → Gateway bölümünde.
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.