BTCPay Server Modülü

14 görüntülenme Markdown

BTCPay Server mağazanızı bağlayarak kripto para ödemelerini kabul edin, onayları ve iade isteklerini WISECP'ten takip edin.

Ekrana Erişim

Ayarlar → Finansal → Ödeme Ağ Geçitleri → Tüm Modüller yolundan BTCPay Server kartına tıklayın: {admin}/modules/payment?module=BTCPayServer

Ekranda Neler Var

Form mağazayı bağlar ve ödeme sayfasını yönetir. Müşteri kendi sunucunuzda ödeme yapmak için BTCPay Server ile Devam Et butonuna tıklar. Modül webhook veya tarayıcı dönüşünden sonra ödeme durumunu sorgular.

İade isteği sunulur; kart saklama, otomatik ödeme, WISECP aboneliği, taksit ve ayrı capture yoktur. BTCPay Server'ın kendi abonelik özellikleri bu modülle WISECP'e bağlanmaz.

Başlamadan Önce

Erişilebilir HTTPS BTCPay Server, mağazayı yönetebilen hesap ve yapılandırılmış cüzdan gerekir. Mağazada kullanacağınız zincir üstü veya Lightning yöntemlerini açın; düğüm eşitlemesini, kurları ve iade bakiyesini kontrol edin.

Sandbox seçeneği ve bağlantı testi butonu yoktur. Ayrı WISECP test sistemi ve BTCPay testnet sunucusu/mağazası kullanın. Sunucu sürümü, modülün güncel Greenfield fatura ve iade API'sini desteklemelidir.

Alanlar

Sunucu AdresiZorunlu; varsayılanı boş. Sunucunun /api/v1 içermeyen HTTPS kök adresi; örneğin https://btcpay.example.com.

API AnahtarıZorunlu; varsayılanı boş. Aşağıdaki izinleri taşıyan ve bu mağazayla sınırlandırılan Greenfield anahtarı.

Mağaza KimliğiZorunlu; varsayılanı boş. Mağazanın ayar sayfasından/adresinden kimliğini kopyalayın. API anahtarının erişebildiği mağazayla eşleşmeli.

Webhook Gizli AnahtarıVarsayılanı boş; imzalı bildirimler için doldurun. Boşken imza kontrolü atlanır, ancak fatura yine API'den sorgulanır.

Onay HızıVarsayılanı Mağaza Ayarını Kullan. Seçenekler: En Hızlı, Onay Beklemez; Bir Onay; İki Onay; Altı Onay. En hızlı seçimde bile RBF işlemi bir onay gerektirir.

Fatura Ömrü (Dakika)İsteğe bağlı; boşken mağaza ayarı kullanılır. Değiştirmek için pozitif dakika girin. Görünen 15 bir örnektir, varsayılan değildir.

Ödeme Yöntemleriİsteğe bağlı; boşken mağazanın etkin yöntemleri sunulur. Sınırlamak için tam kimlikleri virgülle ayırın; örneğin BTC-CHAIN, BTC-LN.

Otomatik Geri DönVarsayılanı açık. Ödeme sayfasından otomatik dönüş ister. Dönüş, ödeme onayının yerine geçmez.

Durum modülü etkinleştirir. Ortak komisyon, dönüşüm, sınırlar ve ülke ayarları Ödeme Modülleri rehberindedir. Bildirimler için Callback URL değerini kopyalayın; Success URL ve Failed URL sonuç adresleridir.

İşlemler

Mağazayı Bağlama

BTCPay Server'da Account → Manage Account → API Keys bölümünü açın. Hedef mağazayla sınırlı bir anahtar oluşturup kaydedin.
Fatura oluşturma/görüntüleme erişimi verin. İade için aşağıdaki tam izinlerle pull payment oluşturma ve yönetme erişimini de ekleyin. Oluşan anahtarı kopyalayın.
WISECP'te Sunucu Adresi, API Anahtarı ve Mağaza Kimliği değerlerini girin. Durum seçeneğini açın, ödeme sayfası seçeneklerini belirleyip Değişiklikleri Kaydet butonuna tıklayın.
Ödeme Ağ Geçitleri → Başlangıç → Etkin Modül Seçimi alanında BTCPay Server'ı seçip Değişiklikleri Kaydet butonuna tıklayın. Yöntem belirlediğiniz sınırlar içinde sunulur.

Webhook Tanımlama

WISECP'ten tam Callback URL değerini kopyalayın. İlgili BTCPay mağazasında Settings → Webhooks bölümünü açıp bu adres için webhook oluşturun.
InvoiceSettled, InvoiceProcessing, InvoiceExpired ve InvoiceInvalid dahil fatura olaylarını etkinleştirin. Otomatik yeniden teslimi açık tutup webhook'u kaydedin.
Gizli anahtarını WISECP'teki Webhook Gizli Anahtarı alanına kopyalayıp Değişiklikleri Kaydet butonuna tıklayın. Bu alana API anahtarını girmeyin.
Test ödemesinden sonra BTCPay Server'da webhook teslimlerini inceleyin. Sağlayıcı durumu Settled olduğunda WISECP'in ilgili faturaya ödemeyi kaydettiğini doğrulayın.

Ödemeyi Test Etme

Ödenmemiş test faturasını ilgili müşteri olarak açıp BTCPay Server'ı seçin. BTCPay Server ile Devam Et butonuna tıklayıp test sunucusunun ağında ödeme yapın.
Sağlayıcı faturasını, tutarı ve para birimini WISECP ile karşılaştırın. New ve Processing ödemeyi açık bırakır; yalnız Settled kapatır.
Süre dolmasını, kesilen tarayıcı dönüşünü ve eksik ödemeyi deneyin. Tekrarlamadan önce onayları bekleyin; sonradan tamamlanan geç ödeme faturayı yine kapatabilir.
Başarılı testlerden sonra ana ağ sunucusunu, mağazayı, API ve webhook anahtarlarını girin. Değişiklikleri Kaydet butonuna tıklayıp canlı webhook'u doğrulayın; sonraki ödemeler gerçek para kullanır.

İade Oluşturma ve Tamamlama

Ödenmiş faturayı açın: {admin}/invoices/detail?id={fatura}. Özet → Durumu Değiştir bölümünde İade Edildi → Ödeme altyapısı ile iade seçip Durumu Güncelle butonuna tıklayın.
Modül, birleşik ödemeler dahil bu faturanın tahsil edilmiş payı için pull payment ister. BTCPay Server'da iadeyi bulun; talep sayfasının bağlantısını müşteriye verin.
Müşteri iade adresini girerek talepte bulunur. BTCPay Server'ın Payouts bölümünde ödemeyi seçip Actions → Approve and send işlemini kullanın.
Cüzdanınızın gerektirdiği imzalama ve yayımlamayı tamamlayın; ödemenin completed durumuna ulaştığını doğrulayın. WISECP'in iade durumu paranın ulaştığını tek başına kanıtlamaz.

Özel tutarlı kısmi iade veya fazla ödeme iadesi için BTCPay Server'da Invoices → Details → Issue a refund yolunu kullanın. Yöntem ve tutarı seçin, talep bağlantısını paylaşın ve ödemeyi tamamlayın. Gerçek tutarı ayrıca takip edin; aynı iadeyi WISECP'ten yeniden başlatmayın.

Dikkat Edilecekler

İade İkinci Adım Gerektirir

Başarılı iade isteği anında para aktarmaz, talep açar. Ağ ücretleri ve kurlar kripto tutarını değiştirebilir. Zaman aşımından sonra yeniden denemeden önce mevcut talepleri doğrulayın.

Teslimden veya Yeni Tahsilattan Önce Doğrulayın

Eksik ödeme ödenmemiş kalır; fazla ödeme ek WISECP bakiyesi oluşturmaz. Sağlayıcıdaki ödenen tutarı ve durumu karşılaştırın. Hızlı onay seçenekleri ek ödeme riski taşır.

Gerekli Yetkiler

WISECP ayarları Modüller → Ödeme Altyapıları (MODULES_PAYMENT_SETTINGS), iadeler Faturalandırma → Düzenleme (INVOICES_OPERATION) yetkisini gerektirir.

Güncel API, btcpay.store.cancreateinvoice ve btcpay.store.canviewinvoices ister. İade için btcpay.store.cancreatepullpayments, mevcut talepleri bulmak için btcpay.store.canmanagepullpayments gerekir. Dördünü seçili mağazayla sınırlayın. Operatör ayrıca webhook yönetimi ve ödeme onaylama/imzalama erişimi taşımalı; modül bunları otomatik yönetmez.

Faydalı oldu mu?

Geri bildiriminiz için teşekkürler!

Hâlâ Yardıma mı İhtiyacınız Var?

Yukarıda bulamadığınız her şey için destek ekibimiz her zaman yanınızda.

Bize Ulaşın Destek Talebi Oluştur