FOSSBilling için kripto ödemeler
FOSSBilling için, müşterilerin faturaları SnapEX Pay üzerinden USDT (TRC20, ERC20, BEP20, Solana, TON, Polygon ve diğer ağlar) ve diğer kripto paralarla ödemesini sağlayan bir ödeme adaptörü. Müşteri bir faturada SnapEX Pay'i seçtiğinde adaptör bir SnapEX Pay faturası oluşturur ve ödeme sayfasına giden bir düğme gösterir (FOSSBilling bunu isterse doğrudan oraya yönlendirir). Ödeme onaylanınca FOSSBilling'in IPN URL'sine imzalı bir webhook gelir, tutar müşteri hesabına işlenir ve fatura ödendi olarak işaretlenir.
Ücretsiz. Sürüm 1.2.0.
Ne yapar
- Cüzdan, node ya da blockchain izleyicisi çalıştırmanız gerekmez: para SnapEX Pay üye işyeri bakiyenize düşer.
- System → Payment gateways bölümünde görünen tek dosyalık bir adaptör.
- Webhook'lar HMAC-SHA256 ve 5 dakikalık zaman aralığıyla doğrulanır; herhangi bir tutar işlenmeden önce fatura SnapEX Pay API'sinden yeniden okunur.
- Ödemeler yalnızca bir kez işlenir: tekrar gelen webhook müşteri hesabına ikinci kez tutar işlemez; veritabanı destekliyorsa ödeme, veritabanı kilidi altında işlenir. Fatura tutarı ödeme adımından sonra değiştiyse hiçbir şey otomatik olarak işlenmez.
- FOSSBilling'in Enable Test Mode ayarı, gerçek para olmadan SnapEX Pay test faturaları oluşturur; ödeme geçidi canlı moddayken test ödemeleri hiçbir zaman işlenmez.
- Her FOSSBilling sitesi yalnızca kendi oluşturduğu faturaları kapatır; USD dışındaki faturalar sabit bir kurla ya da FOSSBilling'in kendi döviz kurlarıyla çevrilir.
Kurulum
- Arşivdeki
SnapexPay.phpdosyasını FOSSBilling kök dizininize,library/Payment/Adapter/SnapexPay/SnapexPay.phpyolunda olacak şekilde kopyalayın (klasör ve dosya adlarında büyük/küçük harf önemlidir) ve web sunucusu kullanıcısının dosyayı okuyabildiğinden emin olun. - Yönetim panelinde System → Payment gateways → New payment gateway bölümüne gidin ve SnapexPay ödeme geçidini kurun.
- Ödeme geçidini açın, SnapEX Pay panelinden aldığınız API anahtarını (yetkiler:
invoices.read,invoices.write) yapıştırın, Enabled ve Allow One Time Payments seçeneklerini işaretleyin ve kaydedin. - Ödeme geçidi sayfasında gösterilen IPN Callback URL'sini (
https://<your-fossbilling>/ipn.php?gateway_id=<id>) kopyalayın, SnapEX Pay panelinde (“Geliştiriciler”) webhook URL'si olarak ayarlayın vewhsec_…gizli anahtarını (yalnızca bir kez, URL ilk kaydedildiğinde gösterilir) Webhook secret alanına yapıştırın. - Enable Test Mode ayarını açın, bir faturayı ödeyin ve test ödemesini SnapEX Pay sayfasında onaylayın; fatura Paid durumuna geçmelidir. Ardından test modunu kapatın.
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ı. İmzasız ya da yanlış imzalı webhook'lar reddedilir. |
| Network fee paid by | merchant: müşteri fatura tutarını öder, komisyon size gelen tutardan kesilir. customer: SnapEX Pay komisyonu ve ağ ücreti tutarın üzerine eklenir. |
| Payment window, minutes | 1–1440, varsayılan 60. |
| USD per 1 unit of invoice currency | USD faturalarda dikkate alınmaz. Diğer para birimleri için sabit bir kur girin ya da FOSSBilling'in kendi döviz kurlarını kullanmak için boş bırakın (USD, System → Currencies altında tanımlı olmalıdır). |
| Enable Test Mode | FOSSBilling'in kendi ayarı: açık — SnapEX Pay test faturaları, kapalı — canlı faturalar. |
| 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 | Boş bırakın. |
Sorular
Hangi FOSSBilling sürümleri destekleniyor?
FOSSBilling 0.8.x ve güncel geliştirme sürümleri.
New payment gateway listesinde SnapexPay görünmüyor.
library/Payment/Adapter/SnapexPay/SnapexPay.php yolunu (büyük/küçük harf önemlidir; ipn.php dosyasının bulunduğu klasöre göre) ve web sunucusunun dosyayı okuyabildiğini kontrol edin.
Müşteri ödedi ama fatura hâlâ ödenmemiş görünüyor.
Invoices → Transactions bölümünü açın. İşlem yoksa SnapEX Pay panelindeki webhook gönderim geçmişini ve URL'de ?gateway_id= parametresinin bulunduğunu kontrol edin. Sorunu giderdikten sonra işlemi yönetim panelinden yeniden işleyebilirsiniz.
Bir işlemde "partially paid", "already paid" veya "total changed" yazıyor.
Bu durumlar hiçbir zaman otomatik olarak işlenmez. Ödemeyi SnapEX Pay panelinde kontrol edin, ardından müşteri hesabına bakiye ekleyin ya da faturayı elle ödendi olarak işaretleyin.
Birden fazla FOSSBilling sitesi tek bir SnapEX Pay hesabını kullanabilir mi?
Her site yalnızca kendi faturalarını kapatır, ancak bir SnapEX Pay hesabının tek bir webhook URL'si vardır ve adaptör ödemeleri yalnızca webhook üzerinden onaylar. Bu yüzden ödemeler yalnızca IPN URL'si webhook olarak ayarlanmış sitede otomatik olarak onaylanı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.