whollycrypto.
हिन्दी

BTCPAY SERVER प्लगइन

आपके BTCPay चेकआउट में स्टेबलकॉइन।

USDC, USDT और स्टोर के दूसरे स्वीकार किए एसेट के लिए Wholly Crypto जोड़ें। मौजूदा BTCPay Bitcoin और Lightning तरीके बनाए रखें।

प्लगइन लें

v1.0.1

BTCPay Server 2.4.4+ और अलग Wholly Crypto इंस्टॉलेशन। BTCPay 2.4.4 के साथ टेस्ट किया गया; नए संस्करण अपने सेटअप पर टेस्ट करें।

प्लगइन डाउनलोड करें ↗GitHub और पूरी गाइड ↗

MIT लाइसेंस · स्वतंत्र कनेक्टर, BTCPay की स्वीकृति या डायरेक्टरी सूची नहीं।

आपका चेकआउट, अधिक विकल्प

  • होस्टेड चेकआउट या वैकल्पिक एम्बेडेड iframe
  • Wholly स्टोर के स्वीकार किए नेटवर्क और एसेट में से चुनें
  • हस्ताक्षरित IPN और प्रमाणित API जाँच
  • खोजने योग्य जुड़े भुगतान और कनेक्शन डायग्नोस्टिक्स

भुगतान आपके Wholly प्रोजेक्ट वॉलेट में आते हैं। कनेक्टर को वॉलेट कुंजियाँ नहीं चाहिए। Wholly प्रोसेसिंग क्रेडिट नियम लागू हैं; प्लगइन प्रतिशत शुल्क नहीं जोड़ता।

इंस्टॉल करें

  1. डाउनलोड करें BTCPayServer.Plugins.WhollyCrypto.btcpay और इसे रिलीज़ के इससे जाँचें: SHA256SUMS। प्लगइन फ़ाइल इस्तेमाल करें, GitHub का स्रोत ZIP नहीं।
  2. BTCPay एडमिन के रूप में खोलें: प्लगइन प्रबंधित करें → प्लगइन अपलोड करें, फ़ाइल अपलोड करके BTCPay रीस्टार्ट करें।
  3. स्टोर चुनें → प्लगइन → Wholly Crypto। केवल इंस्टॉलेशन से स्टोर नहीं जुड़ता।

अपडेट में वही अपलोड प्रक्रिया है। Wholly मर्चेंट सॉफ़्टवेयर अपडेट करने से BTCPay प्लगइन अपडेट नहीं होता।

स्टोर जोड़ें

  1. Wholly में स्वीकार किए तरीके, बैकअप लिए वॉलेट, दरें और पुष्टियों वाला सक्रिय प्रोजेक्ट/स्टोर बनाएँ। वर्तमान मर्चेंट इंस्टॉलेशन इस्तेमाल करें; यह कनेक्टर 6.4.5 API को लक्ष्य बनाता है।
  2. प्रोजेक्ट/स्टोर UUID यहाँ से कॉपी करें: स्टोर → बेसिक → API ID। प्रोजेक्ट-सीमित रीड/राइट API क्रेडेंशियल बनाएँ। सक्रिय करें: स्टोर → IPN और उसका हस्ताक्षर सीक्रेट कॉपी करें, वेबहुक सीक्रेट नहीं।
  3. BTCPay की Wholly सेटिंग्स में ये मान और अपने API व चेकआउट origin डालें, जैसे https://api.example.com और https://pay.example.com। पोर्ट 443 पर सार्वजनिक HTTPS इस्तेमाल करें; पाथ नहीं।
  4. सक्रिय करें: चेकआउट पर Wholly Crypto दें, सहेजें, फिर पढ़ने की पहुँच टेस्ट करें। चाहें तो स्टोर के स्वीकार किए तरीकों का छोटा समूह चुनें।

दोनों फ़ायरवॉल से Wholly सर्वर के HTTPS कॉलबैक को BTCPay तक आने दें। प्लगइन कॉलबैक URL देता है। उस मार्ग पर ब्राउज़र लॉगिन, CAPTCHA और Basic Auth न लगाएँ; हस्ताक्षर जाँच चालू रहनी चाहिए।

एम्बेडेड चेकआउट

पूरे पेज वाला चेकआउट डिफ़ॉल्ट है, खासकर मोबाइल वॉलेट ऐप के लिए उपयोगी। iframe के लिए:

  1. Wholly के स्टोर → एडवांस्डमें सक्रिय करें: एम्बेडेड चेकआउट की अनुमति दें। अपना सटीक BTCPay HTTPS origin यहाँ जोड़ें: अनुमत HTTPS origin, बिना पाथ या वाइल्डकार्ड।
  2. BTCPay की प्लगइन सेटिंग्स में चुनें: ग्राहक चेकआउट → एम्बेडेड चेकआउट (iframe) और सहेजें।
  3. नया इनवॉइस टेस्ट करें। मौजूदा इनवॉइस अपना मूल डिस्प्ले मोड रखते हैं। पूरा चेकआउट खोलें उसी इनवॉइस के लिए उपलब्ध रहता है, अगर फ़्रेम लोड न हो।

ब्राउज़र संदेश और वापसी लिंक नेविगेशन हैं, भुगतान का प्रमाण कभी नहीं।

भुगतान प्रवाह जाँचें

टेस्ट स्टोर में छोटा, सकारात्मक फ़िएट इनवॉइस बनाएँ। चुनें: स्टेबलकॉइन और क्रिप्टो · Wholly। पुष्टि तक चेकआउट, हस्ताक्षरित IPN और API सत्यापन जाँचें। केवल BTCPay के निपटाए इनवॉइस पर हर ऑर्डर एक बार पूरा करें।

पढ़ने की पहुँच टेस्ट करें इनवॉइस बनाना या IPN टेस्ट नहीं करता। इस्तेमाल करें: कनेक्शन और जुड़े भुगतान सुरक्षित त्रुटि विवरण, ऑर्डर संदर्भ और भुगतान जाँच के लिए।

सीमाएँ और डिलीवरी समस्याएँ

केवल तय सकारात्मक फ़िएट इनवॉइस: आठ दशमलव तक, शुरुआत के समय 5 मिनट से 24 घंटे बचे हों। क्रिप्टो-कीमत/टॉप-अप इनवॉइस, मिश्रित तरीके से ऑर्डर पूरा करना और रिफ़ंड इस कनेक्टर में नहीं हैं। देर से या अस्पष्ट भुगतान की समीक्षा चाहिए।

इसके लिए: डिलीवरी विफल, Wholly में स्टोर → IPN → इतिहास → विवरण जाँचें। नेटवर्क पहुँच और हस्ताक्षर सीक्रेट देखें। अनिश्चित परिणाम से बचने के लिए दूसरा इनवॉइस न बनाएँ।

कम प्रोसेसिंग क्रेडिट IPN रोक सकता है जबकि ग्राहक भुगतान कर सकते हैं। क्रेडिट और प्रदाताओं की स्थिति सही रखें। क्रेडिट नियम → · IPN गाइड →