BILLmanager için kripto ödemeler
BILLmanager'da kripto ile ödeme alın. Müşteri bakiye yüklerken ya da sipariş öderken 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 BILLmanager'da otomatik olarak hesaba geçirilir.
Ü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.
- Ödemenin hesaba geçirilmesinin birbirinden bağımsız üç yolu var: imzalı webhook, müşterinin ödeme sayfasından geri dönmesi ve periyodik kontrol (
checkpay). Kaybolan bir webhook yüzünden yapılmış bir ödeme asla hesaba geçmeden kalmaz ve bir ödeme asla iki kez hesaba geçirilmez. - Tutar her zaman SnapEX Pay API'sinden yeniden okunur; yalnızca webhook gövdesine dayanarak hiçbir şey hesaba geçirilmez.
- Kısmi ödemeler otomatik olarak hesaba geçirilmez: log kaydı bunları incelemenizi ister.
- Test modu: test faturaları gerçek para olmadan kendiliğinden onaylanır ve test modu kapatıldıktan sonra asla hesaba geçirilmez.
Kurulum
- BILLmanager sunucusunda root olarak çalıştırın:
tar xzf snapexpay-billmanager-1.1.0.tar.gz,cd snapexpay-billmanager-1.1.0,sh install.sh. Betik modülü/usr/local/mgr5dizinine kopyalar, ek güvence olarak 5 dakikada bir çalışan bircheckpaycron görevi (/etc/cron.d/snapexpay) ekler ve BILLmanager'ı yeniden başlatır. - SnapEX Pay üye işyeri panelinde
invoices.readveinvoices.writeyetkilerine sahip bir API anahtarı oluşturun. - BILLmanager → Provider → Payment methods → Add → SnapEX Pay (crypto). Para birimi: USD. API anahtarını yapıştırın; kaydederken anahtar SnapEX Pay üzerinden doğrulanır.
- Webhook (önerilir): panelde webhook URL'sini
https://<your billing domain>/mancgi/snapexpayresultolarak ayarlayın vewhsec_…gizli anahtarını Webhook secret alanına yapıştırın. - Başka para birimlerinde ödeyen müşteriler: BILLmanager tutarı kendi döviz kurlarıyla ödeme yönteminin para birimine (USD) çevirir; bu yüzden USD kurunu güncel tutun.
- Önce test edin: Test mode açık, yalnızca bir test müşterisine sunulan ayrı bir ödeme yöntemi oluşturun (Payment methods → müşteri grubuna göre kısıtlamalar). Ardından test modunu kapatın ya da bu yöntemi silin.
Ayarlar
| API key | SnapEX Pay panelinden. |
|---|---|
| Webhook secret | Panelin webhook ayarlarındaki whsec_… değeri. Bu alan boşken de ödemeler müşteri döndüğünde ve periyodik kontrolle hesaba geçirilir. |
| Client pays the network fee | Kapalı: müşteri tam olarak ödeme tutarını öder, komisyon size gelen tutardan düşülür. Açık: SnapEX Pay komisyonu ve ağ ücreti tutarın üzerine eklenir. |
| Payment window, minutes | SnapEX ödeme sayfasının ne kadar süre geçerli kalacağı (1–1440, varsayılan 60). Ödeme daha sonra yeniden açılırsa yeni bir sayfa oluşturulur. |
| Test mode | Gerçek para olmadan test faturaları. Bu ayar kapatıldıktan sonra test ödemeleri asla hesaba geçirilmez. |
| API URL | Boş bırakın. |
| 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
Hangi BILLmanager sürümleri destekleniyor?
BILLmanager 6, tüm sürümleri. Modül, BILLmanager sunucusunda yalnızca python3 3.6+ ve standart kütüphaneye ihtiyaç duyar.
Webhook ulaşmazsa ne olur?
Ödeme yine de müşteri ödeme sayfasından döndüğünde ya da 5 dakikada bir çalışan periyodik kontrolle hesaba geçirilir. Bir ödeme asla iki kez hesaba geçirilmez.
Müşterilerim ruble veya başka para birimleriyle ödüyor. Çalışır mı?
Evet. Ödeme yöntemi USD cinsindendir ve BILLmanager tutarı kendi döviz kurlarıyla çevirir; USD kurunu güncel tutun.
Müşteri gerekenden az gönderirse ne olur?
Müşteri eksiği süresi içinde tamamlamazsa hiçbir şey hesaba geçirilmez ve log kaydında “closed with a PARTIAL payment (…) - review in SnapEX Pay and credit manually” yazar.
Müşteri zamanında ödemezse ne olur?
Müşteri yeniden deneyebilsin diye ödeme “In payment” durumunda kalır; son SnapEX faturasının süresi dolduktan bir gün sonra iptal edilir.
Modülü nasıl kaldırırım?
sh install.sh --uninstall komutunu çalıştırın. Ödeme geçmişi var/snapexpay.sqlite dosyasında kalır. Modülün yaptığı her şey /usr/local/mgr5/var/pmsnapexpay.log dosyasına kaydedilir.
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.