BTCPAY SERVER EKLENTİSİ
BTCPay ödeme sayfanda stablecoin'ler.
USDC, USDT ve mağazanın kabul ettiği diğer varlıklar için Wholly Crypto ekle. Mevcut BTCPay Bitcoin ve Lightning yöntemlerini koru.
Eklentiyi al
v1.0.1BTCPay Server 2.4.4+ ve ayrı bir Wholly Crypto kurulumu. BTCPay 2.4.4 ile test edilmiştir; daha yeni sürümleri kendi ortamında test et.
MIT lisanslı · Bağımsız bağlayıcıdır; BTCPay onayı veya dizin kaydı anlamına gelmez.
Ödeme sayfanda daha fazla seçenek
- Barındırılan ödeme sayfası veya isteğe bağlı gömülü iframe
- Wholly mağazasının kabul ettiği ağlar ve varlıklar arasından seç
- İmzalı IPN ve kimlik doğrulamalı API kontrolleri
- Aranabilir bağlantılı ödemeler ve bağlantı teşhisi
Ödemeler Wholly proje cüzdanlarına gider. Bağlayıcı cüzdan anahtarlarına ihtiyaç duymaz. Wholly işlem kredisi kuralları geçerlidir; eklenti ek yüzde ücreti almaz.
Kur
- İndir
BTCPayServer.Plugins.WhollyCrypto.btcpayve sürümün şu dosyasıyla karşılaştır:SHA256SUMS. GitHub kaynak ZIP'ini değil, eklenti dosyasını kullan. - BTCPay yöneticisi olarak şurayı aç: Eklentileri Yönet → Eklenti Yükle, dosyayı yükle ve BTCPay'i yeniden başlat.
- Bir mağaza seç → Eklentiler → Wholly Crypto. Yalnızca kurulum yapmak bir mağazayı bağlamaz.
Güncellemeler aynı yükleme sürecini kullanır. Wholly satıcı yazılımını güncellemek BTCPay eklentisini güncellemez.
Mağaza bağla
- Wholly'de kabul edilen yöntemleri, yedeklenmiş cüzdanları, kurları ve onayları olan etkin bir proje/mağaza oluştur. Güncel bir satıcı kurulumu kullan; bu bağlayıcı 6.4.5 API'sini hedefler.
- Proje/mağaza UUID'lerini şuradan kopyala: Mağaza → Temel → API kimlikleri. Projeyle sınırlı okuma/yazma API kimlik bilgisi oluştur. Şunu etkinleştir: Mağaza → IPN ve webhook sırrını değil, onun imzalama sırrını kopyala.
- BTCPay'in Wholly ayarlarında bu değerleri, API ve ödeme sayfası köken adreslerini gir; örneğin
https://api.example.comvehttps://pay.example.com. 443 portunda herkese açık HTTPS kullan; yol ekleme. - Etkinleştir: Ödeme sayfasında Wholly Crypto sun, kaydet, ardından Okuma erişimini test et. İstersen mağazanın kabul ettiği yöntemlerin bir alt kümesini seç.
Wholly sunucundan BTCPay'e HTTPS geri çağrılarına her iki güvenlik duvarında izin ver. Geri çağrı URL'sini eklenti sağlar. Bu yolda tarayıcı girişi, CAPTCHA ve Basic Auth kullanma; imza kontrolleri etkin kalmalıdır.
Gömülü ödeme sayfası
Tam sayfa ödeme varsayılandır; özellikle mobil cüzdan uygulamaları için yararlıdır. iframe için:
- Wholly'nin şu bölümünde: Mağaza → Gelişmiş, etkinleştir: Gömülü ödeme sayfasına izin ver. Tam BTCPay HTTPS köken adresini şuraya ekle: İzin verilen HTTPS kökenleri, yol veya joker karakter olmadan.
- BTCPay eklenti ayarlarında şunu seç: Müşteri ödeme sayfası → Gömülü ödeme sayfası (iframe) ve kaydet.
- Yeni bir faturayı test et. Mevcut faturalar ilk görüntüleme modunu korur. Tam ödeme sayfasını aç çerçeve yüklenemezse aynı fatura için kullanılabilir kalır.
Tarayıcı mesajları ve dönüş bağlantıları gezinme içindir; asla ödeme kanıtı değildir.
Ödeme akışını kontrol et
Test mağazasında küçük, pozitif tutarlı bir itibari para faturası oluştur. Şunu seç: Stablecoin'ler ve kripto · Wholly. Ödeme sayfasını, imzalı IPN'i ve API doğrulamasını onay aşamasına kadar kontrol et. Siparişi yalnızca BTCPay'de tamamlanmış faturaya dayanarak, sipariş başına bir kez yerine getir.
Okuma erişimini test et fatura oluşturmayı veya IPN'i test etmez. Şunları kullan: Bağlantı ve Bağlantılı ödemeler güvenli hata bilgileri, sipariş referansları ve ödeme kontrolleri için.
Sınırlar ve teslim sorunları
Yalnızca sabit, pozitif tutarlı itibari para faturaları: en fazla sekiz ondalık basamak ve başlatıldığında 5 dakika ile 24 saat arasında kalan süre. Kriptoyla fiyatlandırılmış/bakiye yükleme faturaları, karma yöntemlerle sipariş tamamlama ve iadeler bu bağlayıcının kapsamı dışındadır. Geç veya belirsiz ödemeler inceleme gerektirir.
Şu durum için: Teslim başarısız, Wholly'de Mağaza → IPN → Geçmiş → Ayrıntılar bölümünü kontrol et. Ağ erişimini ve imzalama sırrını kontrol et. Belirsiz sonucu aşmak için başka fatura oluşturma.
Düşük işlem kredisi, müşteriler ödeme yapabilirken bile IPN'i duraklatabilir. Kredini ve sağlayıcılarını sağlıklı tut. Kredi kuralları → · IPN rehberi →