शुरू करें

दस्तावेज़

इंस्टॉल करें, भुगतान स्वीकार करें और अपने सर्वर की देखभाल करें।

नए हैं? चरण-दर-चरण ट्यूटोरियल देखें →

VPS की ज़रूरतें

root पहुँच वाला नया Linux VPS इस्तेमाल करें, मौजूदा वेबसाइट/डेटाबेस सर्वर नहीं। Docker, कंपाइलर या ब्लॉकचेन नोड की ज़रूरत नहीं।

VPSन्यूनतम
हल्का उपयोग
सुझाया गया
CPU1 vCPU2 vCPU
RAM2 GB4 GB
SSD20 GB60 GB

न्यूनतम संसाधन छोटे Ubuntu/Debian इमेज पर हल्के उपयोग की शुरुआत हैं, प्रदर्शन की गारंटी नहीं। डिस्क आकार में Linux शामिल है; सेटअप से पहले कम से कम 3 GiB खाली रखें, साथ में अपडेट, इतिहास और बैकअप की जगह भी।

नेटिव इंस्टॉलर को चाहिए: x86-64, systemd 247+ और Python 3.9+। ARM64 और Alpine/OpenRC शामिल नहीं हैं।

Linux संस्करण और संसाधनों के नोट
  • Ubuntu 22.04+ या Debian 12+; Mint 21+ और Pop!_OS 22+।
  • Fedora 42+; Rocky, AlmaLinux, RHEL, Oracle Linux या CentOS Stream 9–10।
  • openSUSE Leap 16+ या Tumbleweed; Arch, Manjaro या EndeavourOS।

विक्रेता द्वारा बनाए रखा गया रिलीज़ चुनें। OS की अधिक संसाधन ज़रूरतों को प्राथमिकता दें: openSUSE Leap 16 को 40 GB से अधिक डिस्क चाहिए।

अधिक चेन और एक साथ चलने वाले इनवॉइस को अधिक CPU व RAM चाहिए हो सकते हैं। बड़ा VPS, RPC कोटा नहीं हटाता। सेटअप प्रवाह के ऑटोमैटिक टेस्ट हैं; हर वितरण पर नए VPS का पूरा परीक्षण अभी नहीं हुआ है।

इंस्टॉल करें

इन डिफ़ॉल्ट होस्टनाम को अपने VPS पर भेजें, या अपने नाम चुनें:

  • merchant.example.com: कंसोल
  • pay.example.com: चेकआउट
  • api.example.com: API

सेटअप में केवल DNS रिकॉर्ड इस्तेमाल करें। दोनों फ़ायरवॉल में TCP 80/443 खोलें और SSH पहुँच बनाए रखें। PostgreSQL या ऐप के 5432/8080 पोर्ट सार्वजनिक न करें।

bash <(curl -fsSL https://releases.whollycrypto.com/setup_wholly.sh)

सेटअप डाउनलोड सत्यापित करके PostgreSQL, Nginx, HTTPS और सेवाएँ कॉन्फ़िगर करता है। कंटेनर पसंद हैं? देखें: वैकल्पिक Docker इंस्टॉलेशन.

पहले जाँचें या सेटअप जारी करें

कोई खास रिलीज़ चाहिए? नए VPS पर जोड़ें: --version 7.8.1 ठीक वही हस्ताक्षरित संस्करण इंस्टॉल करने के लिए। इसके बिना सेटअप नवीनतम स्थिर रिलीज़ इस्तेमाल करता है।

जारी करने पर चुना रिलीज़ और पूरे चरण बने रहते हैं, GitHub विकल्प के साथ भी। यह मौजूदा इंस्टॉलेशन को कभी पुराने संस्करण पर नहीं लाता।

इंस्टॉलर जाँचें। जोड़ें: --check बिना इंस्टॉल किए संगतता जाँचने के लिए कमांड में; या --help विकल्पों के लिए।

कुंजियाँ या सेटिंग्स बदले बिना सहेजी प्रगति जारी करें:

bash <(curl -fsSL https://releases.whollycrypto.com/setup_wholly.sh) --resume

अतिरिक्त बेस डोमेन वही सेवा नाम इस्तेमाल कर सकते हैं। सभी IPv6 रिकॉर्ड भी इसी VPS पर जाने चाहिए। Cloudflare प्रॉक्सी इसके बाद ही चालू करें: डोमेन सत्यापन.

पहली बार सेटअप

  1. HTTP Basic लॉगिन डालें। अपना एडमिन खाता बनाएँ, भाषा/समय क्षेत्र चुनें और पढ़ें: लाइसेंस और गोपनीयता नीति.
  2. जाँचें: सेटिंग्स → चेन कनेक्शन। भुगतान स्कैनिंग का समर्थन करने वाले स्वस्थ, स्वतंत्र वैकल्पिक प्रदाता इस्तेमाल करें।
  3. प्रोजेक्ट बनाएँ, फिर उसका पहला स्टोर।
  4. प्रोजेक्ट वॉलेट का बैकअप लें। स्टोर में स्वीकार की जाने वाली चेन और सत्यापित टोकन चुनें।
  5. मुद्रा, पुष्टियाँ, समाप्ति समय, स्प्रेड और सहनशीलता तय करें। इनवॉइस बनाने से पहले क्रेडिट बैलेंस जाँचें।

QR पूरी बकाया राशि माँगते हैं। सहनशीलता केवल कम भुगतान को स्वीकार करती है; पुष्टियाँ फिर भी लागू होती हैं।

स्टेबलकॉइन राशियाँ

पहचाने गए स्टेबलकॉइन के नए कोट ऊपर की ओर राउंड होते हैं: 1.321 USDC → 1.33 USDC, शून्य सहनशीलता पर भी। न्यूनतम: 0.01 टोकन।

मौजूदा इनवॉइस, बैलेंस और आंशिक भुगतान के बकाया सटीक रहते हैं। अन्य/कस्टम टोकन सामान्य सटीकता रखते हैं।

अपने आप सक्रिय होना

एडमिन साइनअप आपके ईमेल से क्रेडिट खाता अपने आप पंजीकृत करता है और एक बार देता है: 10 USD के बराबर स्वागत क्रेडिट। सक्रियण कोड की ज़रूरत नहीं।

इनवॉइस बनाएँ। लंबित सक्रियण अपने आप फिर कोशिश करता है; दोबारा कनेक्ट करने पर क्रेडिट फिर नहीं मिलता।

लॉगिन विवरण और डिफ़ॉल्ट

आपका Basic Auth लॉगिन यहाँ सहेजा जाता है: /root/whollycrypto/config/setup-credentials.txt। यह कंसोल ईमेल/पासवर्ड से अलग है।

नए प्रोजेक्ट अपनाते हैं: सिस्टम की डिफ़ॉल्ट मुद्रा और समय क्षेत्र; स्टोर प्रोजेक्ट की मुद्रा इस्तेमाल करते हैं। मौजूदा खातों के समय क्षेत्र सेटिंग्स → खाता में अलग सँभाले जाते हैं।

whollycrypto welcome आपका कंसोल URL दिखाता है।

मर्चेंट या ऑपरेटर मोड

7.0.0 से नए इंस्टॉलेशन पहले एडमिन के सेटअप में मोड चुनते हैं। इसे पलटा नहीं जा सकता; मोड बदलने के लिए नया इंस्टॉलेशन चाहिए। 7 से पहले के इंस्टॉलेशन मर्चेंट मोड में रहते हैं, एडमिन न होने पर भी।

मर्चेंट: अपने प्रोजेक्ट और स्टोर चलाएँ। ऑपरेटर: एक इंस्टॉलेशन पर अलग मर्चेंट व्यवसाय होस्ट करें और अपना प्रीपेड प्रोसेसिंग शुल्क लें। आपका अपना व्यवसाय बिना आंतरिक ऑपरेटर शुल्क के शामिल है।

होस्ट किए गए मर्चेंट सेट करें
  1. साझा नोड, दरें, डोमेन, इंस्टॉलेशन क्रेडिट और अपडेट यहाँ होते हैं: ऑपरेटर पैनल.
  2. खोलें: वॉलेट → भुगतान पाने वाले वॉलेट बनाएँ BTC, ETH और Ethereum USDC/USDT के लिए। दोनों स्वतंत्र रिकवरी फ़्रेज़ का बैकअप लें। यह समर्पित प्रोजेक्ट बिक्री इनवॉइस जारी नहीं कर सकता; मौजूदा प्राप्ति स्टोर सुरक्षित रहता है।
  3. क्रेडिट मुद्रा, शुल्क और एडमिन ईमेल के साथ मर्चेंट जोड़ें। निमंत्रण और मर्चेंट Basic Auth निजी तौर पर साझा करें। वे अपना पासवर्ड चुनते हैं। ऑपरेटर Basic Auth कभी साझा न करें।
  4. मर्चेंट आपके चेकआउट से टॉप-अप करते हैं, या आप कारण सहित क्रेडिट समायोजन दर्ज करते हैं। प्रोजेक्ट/स्टोर बनाने से पहले क्रेडिट चाहिए। उपयोगकर्ता और क्रेडिट इतिहास यहाँ सँभालें: मर्चेंट → प्रबंधन.

ऑपरेटर सेटअप चौथा पता माँगता है, जैसे operator.example.com, और उसका अलग Basic Auth उपयोगकर्ता नाम व पासवर्ड। अपना लेबल चुनें, DNS को VPS पर भेजें, DNS जाँचें और HTTPS सक्रिय करें। पैनल सीधे उस पते पर खुलता है। मर्चेंट, चेकआउट और API पते अलग रहते हैं।

नया ऑपरेटर Basic Auth लॉगिन, फिर अपना एडमिन ईमेल/पासवर्ड इस्तेमाल करें। मर्चेंट Basic Auth नहीं बदलता। DNS या सर्टिफ़िकेट त्रुटि के बाद सेटअप जारी हो सकता है। 7.0.0 से अपडेट करने वाले ऑपरेटर भी यह चरण पूरा करते हैं; मौजूदा लाइव पते उपलब्ध रहते हैं।

शुल्क, अलगाव और ज़िम्मेदारी

3% पर 100 EUR के इनवॉइस में 3 EUR मर्चेंट क्रेडिट लगता है। क्रेडिट मुद्रा अलग हो तो बनाते समय की फ़िएट दर शुल्क के साथ सहेजी जाती है।

ऑपरेटर सामान्य Wholly Crypto इंस्टॉलेशन शुल्क अलग देता है। ग्राहक फंड ऑन-चेन नहीं बाँटे जाते। क्रेडिट खरीद पर दोबारा शुल्क नहीं लगता।

केवल अपने आप सत्यापित निपटान से टॉप-अप क्रेडिट मिलता है। चेकआउट खोलने या इनवॉइस खुद स्वीकार करने से नहीं। रिवर्सल लेजर प्रविष्टियाँ बनाते हैं; पलटा गया टॉप-अप फिर लौटे तो ऑपरेटर समीक्षा चाहिए।

कम होस्टेड क्रेडिट IPN, वेबहुक, स्वीप और नए प्रोजेक्ट/स्टोर बनाना रोकता है। मौजूदा ग्राहक इनवॉइस और भुगतान पाना जारी रहता है। कम इंस्टॉलेशन क्रेडिट होस्ट किए व्यवसायों का ऑटोमेशन रोक सकता है। मर्चेंट निष्क्रिय करने पर लॉगिन और नए इनवॉइस भी रुकते हैं, जबकि पुराने भुगतान की निगरानी जारी रहती है।

यह ऐप स्तर का अलगाव है, हर मर्चेंट के लिए अलग VPS नहीं। मर्चेंट एक-दूसरे के प्रोजेक्ट, वॉलेट, API क्रेडेंशियल, एक्सचेंज या क्रेडिट नहीं देख सकते। सर्वर एडमिन होस्ट किए हॉट वॉलेट की कुंजियाँ पा सकता है। शामिल करने से पहले मर्चेंट को बताएँ; विश्वसनीय होस्टिंग, स्वतंत्र बैकअप और साझा कार्यभार के लिए पर्याप्त क्षमता इस्तेमाल करें।

ऑपरेटर वित्त और निमंत्रण

ऑपरेटर मोड में 7.1.0 से उपलब्ध।

वॉलेट और वित्त

7.2.0 से, वॉलेट प्राप्ति बैलेंस, पते और बैकअप सँभालता है; स्वीप भेजना और ऑटोमैटिक नियम सँभालता है। टोकन शुल्क के लिए ETH रखें। मर्चेंट टॉप-अप उनकी खरीद ट्रैक करता है। हेडर के क्रेडिट इंस्टॉलेशन शुल्क अलग चुकाते हैं। मेरा व्यवसाय आपका अपना कंसोल नए टैब में खोलता है।

खोलें: वित्त कमाए शुल्क, सत्यापित इंस्टॉलेशन खर्च, अनुमानित मार्जिन और वर्तमान मर्चेंट क्रेडिट के लिए। तारीख, मर्चेंट या रिपोर्टिंग मुद्रा से फ़िल्टर करें; CSV एक्सपोर्ट करें।

रिपोर्ट इनवॉइस को पहले निपटान के अनुसार समूहित करती हैं और उनके नवीनतम शुल्क रिवर्सल दिखाती हैं। प्रीपेड बैलेंस आय नहीं है। अपने व्यवसाय के शुल्क अलग रहते हैं। लंबित शुल्क या गुम दरों से संबंधित मार्जिन उपलब्ध नहीं रहता। बदली हुई राशियाँ वर्तमान कैश की गई फ़िएट दरें इस्तेमाल करती हैं; गैस और संचालन खर्च शामिल नहीं हैं।

उपयोगकर्ता बुलाएँ या पासवर्ड रीसेट करें

मर्चेंट जोड़ें निमंत्रण बनाता है। 7.3.0 से मर्चेंट की क्रेडिट मुद्रा में मुफ़्त शुरुआती क्रेडिट चुनें; शून्य भी मान्य है। इससे आपका ऑपरेटर बैलेंस नहीं भरता। ईमेल से निमंत्रण भेजें डिफ़ॉल्ट रूप से चुना होता है।

अपना SMTP प्रदाता यहाँ कॉन्फ़िगर करें: सेटिंग्स → निमंत्रण ईमेल पहले TLS या STARTTLS के साथ। कनेक्शन टेस्ट ईमेल नहीं भेजता। चाहें तो ईमेल हटाकर लिंक निजी तौर पर साझा करें। ईमेल विफल हो तो खाता और क्रेडिट सुरक्षित रहते हैं; मर्चेंट दोबारा न बनाएँ।

दूसरे लिंक या पासवर्ड रीसेट के लिए खोलें: मर्चेंट → प्रबंधन → उपयोगकर्ता खाते। SMTP द्वारा स्वीकार होना इनबॉक्स में पहुँचने की गारंटी नहीं। मर्चेंट Basic Auth अलग साझा करें, ऑपरेटर क्रेडेंशियल कभी नहीं।

निमंत्रण 48 घंटे और रीसेट एक घंटे तक मान्य है। दोनों एक बार काम करते हैं। उसी स्क्रीन से लिंक बदलें या रद्द करें। रीसेट मौजूदा सत्र बंद करता है लेकिन 2FA चालू रखता है। मर्चेंट Basic Auth फिर भी चाहिए।

ऑपरेटर API

SDK 2.6.0 और Wholly Crypto 7.4.0+ से होस्ट किए मर्चेंट का ऑटोमेशन करें। सक्रिय करें: ऑपरेटर → सेटिंग्स → ऑपरेटर API, फिर सीमित दायरे वाली सर्वर-साइड कुंजी बनाएँ।

जुड़ने की प्रक्रिया, अनुमतियाँ और सुरक्षित पुनः प्रयास

पासवर्ड से सीधे खाते बनाएँ या निमंत्रण भेजें। उपयोगकर्ता, प्रोजेक्ट, स्टोर, शुल्क और स्थानीय प्रीपेड क्रेडिट सँभालें; रिपोर्ट पढ़ें और हस्ताक्षरित जीवनचक्र घटनाओं की सदस्यता लें। पहले लॉगिन पर कस्टडी सहमति, 2FA और खातों का अलगाव बना रहता है।

हर लिखने वाले अनुरोध के लिए सहेजी हुई idempotency कुंजी चाहिए। क्रेडिट अनुदान स्थानीय खाता समायोजन हैं, इंस्टॉलेशन टॉप-अप नहीं। वॉलेट की गुप्त जानकारी, पैसे भेजना और सर्वर कॉन्फ़िगरेशन इस API में नहीं हैं।

इस्तेमाल करें: api.your-domain.com/v1/operator। ऑपरेटर कुंजियाँ अपने बैकएंड पर रखें, ब्राउज़र में या होस्ट किए मर्चेंट के पास कभी नहीं।

ऑपरेटर API संदर्भ और अनुमतियाँ → · आधिकारिक SDK और उदाहरण →

वॉलेट और टोकन

सेटिंग्स → टोकन पहले 250 टोकन लोड करता है, फिर बाकी कैटलॉग।

प्रोजेक्ट → वॉलेट → सबका बैकअप TXT या QR कोड वाला खोजने योग्य ऑफ़लाइन HTML एक्सपोर्ट करता है। दोनों कुंजियाँ और रिकवरी फ़्रेज़ दिखाते हैं। सर्वर से बाहर निजी प्रति रखें; साझा या अपलोड न करें।

Root कुंजियों तक पहुँच सकता है। वॉलेट रिकवरी गाइड इनवॉइस पते, नेटिव गैस और बाहरी Monero/Lightning बैकअप समझाती हैं।

सहेजे पते और ताज़ा बैलेंस

सेटिंग्स → पता पुस्तिका: चेन/पता सहेजें। नेटिव कॉइन और मेल खाते CoinGecko टोकन अपने आप दिखते हैं। केवल पढ़ने योग्य, एडमिन द्वारा प्रबंधित; चेकआउट की स्वीकृति नहीं बदलती।

टोकन रीडर 22 चेन कवर करते हैं। निजी बैलेंस और Bitcoin/CashTokens/Kaspa पर अतिरिक्त टोकन परतों के लिए अलग पहुँच या इंडेक्सर चाहिए। पढ़ना विफल हो तो त्रुटि दिखती है, शून्य नहीं।

इनवॉइस बैलेंस दूसरे वॉलेट में इकट्ठा करें: मैनुअल भेजने या ऑटोमैटिक स्वीप से। टोकन ट्रांसफ़र के शुल्क के लिए चेन का नेटिव कॉइन भी चाहिए।

कीमत उपलब्ध नहीं का संबंध दरों से है, बैलेंस से नहीं।

कस्टम टोकन जोड़ें
  1. स्टोर → भुगतान के तरीके → EVM या Solana → कस्टम टोकन.
  2. कॉन्ट्रैक्ट/मिंट, नाम और टिकर डालें। तय USD या ऑटोमैटिक DEX कीमत चुनें।

नेटवर्क/दशमलव जाँचे जाते हैं। प्रोजेक्ट-व्यापी कीमतें पुराने कोट नहीं बदलतीं। कैटलॉग में मिलना भर चेकआउट सक्रिय नहीं करता।

ऑटोमैटिक कीमत

DEX Screener को ठीक उसी कॉन्ट्रैक्ट का पूल, $10,000 तरलता और एक घंटे के भीतर ट्रेड चाहिए। दरें हर मिनट ताज़ा होती हैं; विफल या पाँच मिनट पुरानी दरें नए कोट रोकती हैं।

DEX कीमतों में हेरफेर हो सकता है; जाँच ऑडिट नहीं है। भरोसेमंद मानक ERC-20 या क्लासिक SPL टोकन इस्तेमाल करें। Token-2022/एक्सटेंशन समर्थित नहीं हैं। उपयुक्त पूल न हो तो तय कीमत इस्तेमाल करें।

मुद्रा और समय क्षेत्र

सेटिंग्स → सिस्टम → क्षेत्रीय डिफ़ॉल्ट नए प्रोजेक्ट की मुद्रा/समय क्षेत्र और नए खाते का समय क्षेत्र तय करता है। मौजूदा सेटिंग्स और क्रेडिट नहीं बदलते; डैशबोर्ड मुद्रा अब भी बदली जा सकती है।

व्यक्तिगत समय क्षेत्र: सेटिंग्स → खाता → उपयोगकर्ता संपादित करें.

इनवॉइस बनाएँ

इस्तेमाल करें: भुगतान के तरीके → इस इनवॉइस के लिए चुनें स्वीकार की गई चेन/टोकन सीमित करने के लिए। स्टोर के सभी भुगतान तरीके डिफ़ॉल्ट बनाए रखता है।

  1. खोलें: प्रोजेक्ट → इनवॉइस → इनवॉइस बनाएँ.
  2. स्टोर, फ़िएट मुद्रा और राशि चुनें।
  3. चेकआउट लिंक साझा करें। ग्राहक उपलब्ध चेन/टोकन चुनकर QR, बची राशि, समाप्ति और पुष्टियाँ देखता है।

लाइव होने से पहले हर तरीके पर छोटा भुगतान टेस्ट करें। ऑर्डर पूरा करने से पहले इनवॉइस जाँचें: वापसी URL भुगतान का प्रमाण नहीं है।

इंटीग्रेशन में हस्ताक्षरित IPN/वेबहुक सत्यापित करें और स्थिति इसकी मदद से पक्की करें: इनवॉइस API। दोहराई गई घटनाओं को वही घटना मानें।

API: फ़िल्टर करें payment_methods इसके अनुसार: chain_slug और asset_tickers। निष्क्रिय विकल्प अनदेखे होते हैं; कुछ न मिले तो स्टोर डिफ़ॉल्ट। केवल चेन चुनने पर सभी सक्रिय एसेट शामिल हैं। साझा टिकर के लिए एसेट ID चाहिए। वॉलेट और दरें फिर भी ज़रूरी हैं।

राशियाँ और पुष्टियाँ

स्कैनर ऑफ़लाइन है? इनवॉइस कॉन्फ़िगर किए तरीके बनाए रखते हैं जबकि पहचान इंतज़ार करती है। चेन कनेक्शन में समर्थित API जाँचें; स्वस्थ होना स्कैनर-संगत होना नहीं है। डिफ़ॉल्ट: दो स्वतंत्र प्रदाता।

वॉलेट/दरें फिर भी ज़रूरी हैं। Monero/Lightning सेवाओं को भुगतान अनुरोध जारी करने होंगे।

API/MCP त्रुटियों में शामिल है: error.details.payment_methods। SDK 2.4.0 सुरक्षित विवरण जोड़ता है: PHP getPaymentMethodIssues(), Python payment_method_issues, Node paymentMethodIssues. त्रुटि संदर्भ →

क्रिप्टो कोट ऊपर की ओर राउंड होते हैं और स्टोर का स्प्रेड शामिल करते हैं। फ़िएट में कीमत वाला इनवॉइस प्राप्त क्रिप्टो को बैंक बैलेंस में नहीं बदलता।

शून्य पुष्टियों पर पहचान होते ही निपटान होता है, नेटवर्क पुष्टि की सुरक्षा के बिना। नेटिव EVM भुगतान सीधे ट्रांसफ़र के रूप में पहचाने जाते हैं। असामान्य या अनिश्चित भुगतान यहाँ देखें: ध्यान देने की ज़रूरत.

स्कैनर API

जाँचें: चेन कनेक्शन संगत API, पूरा इतिहास और स्वतंत्र प्रदाताओं के लिए। रॉ नोड को पिछला डेटा पूरा करने में समय लगता है। भुगतान पाने वाले सभी API →

भुगतान, बैलेंस और रखरखाव प्रदाता बजट साझा करते हैं। निष्क्रिय जाँचें धीमी होती हैं। पुराने इनवॉइस पर देर से भुगतान/रीऑर्ग की निगरानी रहती है; पिछला डेटा पूरा होने के बाद अंतराल एक घंटे तक हो सकता है। उपलब्ध WSS संकेत HTTP स्कैनिंग के साथ काम करते हैं। चेकआउट बंद करने से पहचान नहीं रुकती। सार्वजनिक नोड की सीमाएँ फिर भी रहती हैं; Wholly Crypto कोई नोड नहीं चलाता।

शून्य राशि के इनवॉइस

डिफ़ॉल्ट रूप से बंद। सक्रिय करें: स्टोर → इनवॉइस → शून्य राशि के इनवॉइस की अनुमति दें मैनुअल/API शून्य कुल की अनुमति के लिए। वे बिना भुगतान, प्राप्ति पते, ट्रांज़ैक्शन या प्रोसेसिंग शुल्क के तुरंत पूरे होते हैं।

चेकआउट

स्टोर → चेकआउट: रंग, लोगो, तरीके, लिंक, शुरुआती/अंतिम संदेश के फ़ॉन्ट आकार और प्रोजेक्ट/स्टोर नाम की दृश्यता। नए स्टोर डिफ़ॉल्ट स्टोर का डिज़ाइन लेते हैं। बदलाव अपने आप सहेजते हैं।

प्रीव्यू भुगतान स्वीकार नहीं कर सकते। कस्टम HTML/CSS/JavaScript नहीं।

डेमो आज़माएँ.

IPN और वेबहुक

IPN हर इनवॉइस घटना भेजता है स्टोर URL या इनवॉइस के ipn_urlपर। वेबहुक चुनी घटनाएँ भेजते हैं। दोनों वही JSON स्नैपशॉट POST करते हैं।

ऑर्डर कब पूरा करूँ? घटना-आधारित प्रबंधन में इस्तेमाल करें: event_type = invoice.settled इसके साथ: status = settled। वर्तमान इनवॉइस और अपना ऑर्डर सत्यापित करके केवल एक बार पूरा करें। payment.received अकेला पर्याप्त नहीं है।

स्थिति बनाम घटनाएँ: Ethereum और Solana के उदाहरण

status घटना बनते समय इनवॉइस की स्थिति है; event_type बताता है कि क्या हुआ।

  • Ethereum उदाहरण: payment.received + processing, फिर invoice.settled + settled.
  • Solana उदाहरण: पहचान होते समय ही अंतिम हो चुका है, इसलिए payment.received और invoice.settled दोनों में होता है: settled.

दूसरी चेन पर दोनों में से कोई प्रवाह हो सकता है। ये अलग घटनाएँ हैं, ज़रूरी नहीं कि दो भुगतान हों। इनमें एक जैसा हो सकता है: sequence लेकिन अलग होते हैं: event_id के मान। डिलीवरी का क्रम तय नहीं है; यह ज़रूरी न मानें कि processing पहले आए।

स्थितियाँ और कॉलबैक डेटा
इनवॉइस की स्थितिमतलब
newभुगतान का इंतज़ार
processingआंशिक भुगतान या अंतिमता का इंतज़ार
settledइनवॉइस नियमों के अनुसार या मैनुअल रूप से स्वीकार किया गया
expiredसमय सीमा बीती; देर से भुगतान की निगरानी जारी रह सकती है
invalidभुगतान की समीक्षा चाहिए या उसे अस्वीकार किया गया
cancelledरद्द किया गया, रिफ़ंड नहीं हुआ

घटनाएँ: invoice.created, payment.received, invoice.processing, invoice.settled, invoice.expired, invoice.invalid, invoice.cancelled. पूरी घटना तालिका और अपवाद नियम →

amount_status: none, partial, paid, overpaid. paid में सहनशीलता शामिल है, अंतिमता नहीं। timing_status: on_time या late. resolution: automatic, manually_settled या manually_invalidated। अपनी अपवाद नीति लागू करें जब requires_review true हो।

invoice_id API उत्तर से मेल खाता है। amount, currency और order_id आपका मूल ऑर्डर बताते हैं। payment_info ट्रांसफ़र, सटीक क्रिप्टो राशि, लॉक किया कोट/स्प्रेड/सहनशीलता और सलाहकारी दरें जोड़ता है। ग्राहक डेटा और मेटाडेटा निजी हैं।

paid_chain, paid_asset, paid_payment_method_id, paid_asset_amount, paid_asset_amount_received और settlement_exchange_rate निपटान का सार देते हैं। ये स्थिर रहते हैं; गुम प्रमाण/इतिहास null रहता है। बाद के भुगतान के लिए इस्तेमाल करें: payment_info या पेमेंट API.

दशमलव स्ट्रिंग इस्तेमाल करें। अलग एसेट न मिलाएँ और अपुष्ट फंड को गायब न मानें। अपवाद स्पष्ट रूप से सँभालें; केवल चेतावनी ऑर्डर पूरा करने या रिफ़ंड की अनुमति नहीं देती। सत्यापित आंतरिक गैस टॉप-अप ग्राहक भुगतान नहीं हैं और यह ट्रिगर नहीं करते: payment.received.

हस्ताक्षर के सीक्रेट, पुनः प्रयास और डिलीवरी इतिहास

हस्ताक्षर के अलग सीक्रेट: स्टोर → IPN IPN डिलीवरी पर हस्ताक्षर करता है, इनवॉइस के कस्टम ipn_urlसहित। यहाँ हर एंडपॉइंट: स्टोर → वेबहुक का अपना सीक्रेट है, जो बनाते या बदलते समय दिखता है।

दोनों इस्तेमाल करते हैं: Wholly-Signature और वही SDK सत्यापक, लेकिन API कुंजी नहीं, मेल खाता सीक्रेट चाहिए। IPN सीक्रेट बदलने से वेबहुक सीक्रेट नहीं बदलते।

रॉ बॉडी, टाइमस्टैम्प और प्रोजेक्ट/स्टोर दायरा सत्यापित करें। स्थायी रूप से सहेजकर HTTP 2xx लौटाएँ। वर्कर आपके कॉन्फ़िगर किए API होस्ट से वर्तमान इनवॉइस जाँचता है और डेटाबेस ट्रांज़ैक्शन में ऑर्डर एक बार पूरा करता है। हेडर हस्ताक्षरित नहीं हैं; संस्करण 2 की हस्ताक्षरित बॉडी पहचान इस्तेमाल करें।

घटना-आधारित: हस्ताक्षरित इस मान से दोहराव हटाएँ: event_id, फिर फ़िल्टर करें: invoice.settled. SDK स्थिति-आधारित: प्रोजेक्ट + इनके आधार पर संशोधन एक करें: invoice_id + sequence, फिर घटना प्रकार से अलग स्थिति जाँचें। इस तरह एक करने के बाद घटना फ़िल्टर न जोड़ें। दोनों को ऑर्डर स्तर पर अलग दोहराव सुरक्षा चाहिए।

पुनः प्रयास मूल बॉडी और घटना ID बनाए रखते हैं। पुराने संशोधन नए संशोधनों पर नहीं लिखने चाहिए। IPN आठ बार तक कोशिश करता है; वेबहुक पुनः प्रयास वैकल्पिक हैं। कम क्रेडिट डिलीवरी रोकता है, भुगतान नहीं।

स्टोर → IPN / वेबहुक → इतिहास → विवरण सहेजी बॉडी और परिणाम दिखाता है। पेलोड 90 दिन बाद समाप्त होते हैं। दोबारा भेजना निपटान का प्रमाण नहीं है।

पूरा पेलोड, घटना तालिका और रिसीवर उदाहरण →

एक्सचेंज रूपांतरण

समर्थित एसेट Kraken, Binance या Coinbase भेजें। कॉइन रखें या खाते में आए डिपॉज़िट बदलें। फ़िएट एक्सचेंज पर रहता है।

डिपॉज़िट की न्यूनतम सीमा हर ट्रांज़ैक्शन पर लागू है, हर स्वीप पर नहीं। न्यूनतम से कम डिपॉज़िट प्लान रोकते हैं। पहले छोटे बैलेंस अपने वॉलेट में इकट्ठा करें; अतिरिक्त नेटवर्क शुल्क लगता है।

जोड़ें और मार्ग चुनें
  1. सेटिंग्स → एक्सचेंज: समर्पित कुंजी जोड़ें, बैलेंस जाँचें और प्रोजेक्ट को पहुँच दें। निकासी अनुमति न दें; कुंजी को VPS IP तक सीमित करें।
  2. प्रोजेक्ट → स्वीप: एसेट, नेटवर्क, पता और टोकन कॉन्ट्रैक्ट सत्यापित करें। हर चेन/टोकन के लिए दूसरा वॉलेट या एक एक्सचेंज चुनें।

बाज़ार हर दो मिनट में ताज़ा होते हैं। केवल मेल खाते, खाते में आए डिपॉज़िट बदल सकते हैं; पुराने बाज़ार डेटा से नए ऑर्डर रुकते हैं। शुल्क/राउंडिंग के लिए स्रोत राशि का 1% एक्सचेंज पर रहता है, प्रोसेसिंग क्रेडिट से अलग।

न्यूनतम राशि रखें ऑटोमैटिक स्वीप के बाद पूरे प्रोजेक्ट में कॉइन/टोकन बचाता है। यह ट्रिगर से अलग है; शून्य पर कुछ नहीं बचता। शुल्क अतिरिक्त राशि से जाता है। मैनुअल भेजना नहीं बदलता।

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

एक्सचेंज की कस्टडी, KYC, क्षेत्रीय सीमाएँ और शुल्क लागू हैं। बैंक भुगतान या लीवरेज नहीं। कम क्रेडिट नए रूपांतरण रोकता है; भेजे ऑर्डर का मिलान जारी रहता है।

प्रोसेसिंग क्रेडिट

क्रेडिट खत्म होने पर भी भुगतान मिलते हैं। मौजूदा स्टोर में इनवॉइस, चेकआउट और भुगतान निगरानी चालू रहती है। सत्यापित बिलिंग कनेक्शन न होना या खाता निलंबन अलग है और नए इनवॉइस रोक सकता है।

अब भी उपलब्धइस्तेमाल योग्य क्रेडिट न हो तो रुकता है
इनवॉइस, चेकआउट और पुष्टियाँIPN/वेबहुक, पुनः प्रयास सहित
वॉलेट, बैलेंस और बैकअपस्वीप: भेजना, गैस, रिफ़ंड और नए एक्सचेंज रूपांतरण
रिपोर्ट, रीड API और मौजूदा सेटिंग्सप्रोजेक्ट और स्टोर बनाना
अपडेट जाँच और रुके अपडेट की रिकवरीनए संस्करण इंस्टॉल करना

क्रेडिट आइकन से टॉप-अप करें। सुधार सत्यापित होने के बाद सक्रिय ऑटोमेशन फिर चलता है, फंड भेजने वाले स्वीप नियम भी। जिन्हें फिर नहीं चलाना चाहते, वे नियम बंद करें।

ऑटोमैटिक क्रेडिट टॉप-अप

खोलें: ऑटो टॉप-अप अनुरोधों के बाद। बैकअप लिया हुआ प्राप्ति वॉलेट, सीमा, खरीद राशि, दैनिक सीमा और नेटवर्क शुल्क सीमा चुनें। अनुमति देकर सहेजें। शुरुआत में बंद रहता है।

उपलब्ध हों तो BTC, ETH या Ethereum USDC/USDT इस्तेमाल करें। टोकन भेजने वाले पतों पर ETH चाहिए; यह नियम गायब गैस नहीं भरता। ऑपरेटर समर्पित प्राप्ति वॉलेट इस्तेमाल करते हैं; होस्ट किए मर्चेंट अपने ऑपरेटर को भुगतान करते हैं।

कम क्रेडिट से स्वीप रुका हो तब भी मंज़ूर टॉप-अप चल सकता है। केवल प्राप्त करने वाली सेवा क्रेडिट की पुष्टि करती है। एक समय में एक ऑटोमैटिक खरीद चलती है। बंद करने से न भेजा काम रुकता है, भेजे ट्रांज़ैक्शन नहीं।

ऑटोमैटिक भुगतान रिकवर करें

ऑटो टॉप-अप में इस्तेमाल करें: भुगतान जाँचें। वही मान्य भुगतान जारी करें, या सत्यापित असफल Ethereum ट्रांसफ़र बंद करके नियम रोकें। दोबारा भेजने से बचाने के लिए लंबित या अनिश्चित भुगतान होल्ड पर रहते हैं। कोट समाप्त होना असफलता का प्रमाण नहीं है।

शुल्क और पूरी पहुँच बहाल करना

डिफ़ॉल्ट 1% निपटाए गए इनवॉइस के मूल फ़िएट मूल्य पर है। ग्राहक के क्रिप्टो भुगतान नहीं बाँटे जाते।

शुल्क जुड़कर बैलेंस ऋणात्मक कर सकते हैं। ऋणात्मक राशि चुकाएँ और खाते की छूट सीमा से ऊपर इस्तेमाल योग्य क्रेडिट बहाल करें। स्वस्थ कनेक्शन पर बैलेंस बदलाव आमतौर पर 10–15 सेकंड में दिखते हैं।

ऑटोमेशन की छूट होने पर भी अपडेट इंस्टॉल करने के लिए शून्य से अधिक सत्यापित क्रेडिट चाहिए। टॉप-अप कभी अपने आप अपडेट इंस्टॉल नहीं करता।

रुकी सूचनाएँ प्रयास नहीं गिनतीं। सुरक्षित डिलीवरी फिर चलती हैं; सामान्य समाप्ति फिर भी लागू है। छूटी घटनाओं का इनवॉइस API से मिलान करें।

ऑपरेटर प्रोसेसिंग शुल्क बंद करे तो नए प्रोसेसिंग शुल्क या क्रेडिट पाबंदी नहीं लगती। पुराने शुल्क इतिहास में रहते हैं। बिना पेयर किए इंस्टॉलेशन में प्रोजेक्ट/स्टोर कॉन्फ़िगर हो सकते हैं, लेकिन इनवॉइस जारी करने के लिए सत्यापित बिलिंग चाहिए। जारी इनवॉइस की निगरानी रहती है।

रिपोर्ट

आय चार्ट और फ़िल्टर टैब के ऊपर रहते हैं: प्रोजेक्ट और स्टोर, इनवॉइस, वॉलेट और स्वीप। नीचे खोजें। प्रोजेक्ट और स्टोर में CSV एक्सपोर्ट हैं। कस्टम तारीखें 366 दिन तक की हो सकती हैं। वॉलेट कैश किए बैलेंस इस्तेमाल करते हैं।

रिपोर्ट के आँकड़े कैसे काम करते हैं
  • आय, निपटान तारीखों के अनुसार शुल्क/रिफ़ंड से पहले निपटाए इनवॉइस के मूल्य दिखाती है। यह वॉलेट बैलेंस या मुनाफ़ा नहीं है।
  • रूपांतरण वर्तमान कैश दरें इस्तेमाल करते हैं, ऐतिहासिक लेखांकन दरें नहीं। दरें न हों तो मूल मुद्रा के कुल उपलब्ध रहते हैं।
  • इनवॉइस स्थिति चार्ट इनवॉइस बनाने की तारीखें इस्तेमाल करते हैं। ध्यान देने की ज़रूरत वाले आँकड़े वर्तमान अनसुलझे मुद्दे दिखाते हैं।

AI सहायक · MCP

वैकल्पिक, प्रोजेक्ट-सीमित पहुँच यहाँ: api.example.com/mcp। भुगतान पढ़ें या इनवॉइस बनाने की अनुमति दें। MCP सेटअप और अनुमतियाँ →

शॉप प्लगइन

PrestaShop → · OpenCart → · सभी प्लगइन →

SDKs

इनवॉइस बनाने, भुगतान जाँचने और IPN/वेबहुक सत्यापित करने के लिए हमारे आधिकारिक SDK इस्तेमाल करें।

PHP SDK

PHP 7.4+

Composer से अपने PHP ऐप में क्रिप्टो भुगतान जोड़ें।

composer require whollycrypto/php-sdk
GitHub और उदाहरण ↗

Python SDK

Python 3.10+

बिना रनटाइम निर्भरता अपने Python ऐप या बैकएंड को जोड़ें।

python -m pip install whollycrypto
GitHub और उदाहरण ↗

Node.js SDK

Node.js 22+

JavaScript या TypeScript, बिल्ट-इन टाइप वाला एक npm पैकेज।

npm install whollycrypto
GitHub और उदाहरण ↗

अपने इंस्टॉलेशन का API डोमेन इस्तेमाल करें और API कुंजियाँ सर्वर पर रखें। सभी SDK MIT लाइसेंस वाले हैं।

भुगतान टूल

प्रोजेक्ट → भुगतान टूल खोलें और स्टोर चुनें। दोबारा इस्तेमाल होने वाला भुगतान लिंक साझा करें, बिक्री स्थल पर भुगतान लें या ईमेल से भुगतान अनुरोध निर्धारित करें।

कीमत और भुगतान प्रवाह चुनें
  • तय फ़िएट: हर नया चेकआउट वर्तमान क्रिप्टो दरें और स्टोर स्प्रेड इस्तेमाल करता है, फिर कोट समाप्ति तक लॉक करता है।
  • तय क्रिप्टो: स्वीकार किए गए एक ऑन-चेन एसेट की सटीक इकाइयाँ माँगें। रिपोर्टिंग और शुल्क के लिए ऊपर राउंड किया ताज़ा फ़िएट मूल्य दर्ज होता है; स्प्रेड क्रिप्टो राशि नहीं बदलता।
  • दान: ग्राहकों को आपकी सीमाओं के भीतर राशि डालने दें। तुरंत चुनने वाली राशियाँ और वैकल्पिक नाम/ईमेल फ़ील्ड जोड़ें।
  • बिक्री स्थल: राशि या ऑर्डर संदर्भ डालें और चेकआउट QR दिखाएँ। केवल भुगतान पहचाने जाने का नहीं, settled होने का इंतज़ार करें।
  • निर्धारित अनुरोध: चुने समय क्षेत्र में एक बार, हर हफ़्ते या हर महीने भेजें। ग्राहक हर इनवॉइस खुद चुकाते हैं। वॉलेट से ऑटोमैटिक कटौती नहीं।

स्टोर का रूप, पुष्टियाँ और कॉलबैक लागू रहते हैं। टूल रोकने से नए अनुरोध रुकते हैं, मौजूदा भुगतान नहीं। इतिहास हर इनवॉइस से जुड़ता है। छूटे अंतराल एक साथ ढेर सारे ईमेल नहीं भेजते; दोबारा भेजना वही बकाया, गैर-समाप्त इनवॉइस इस्तेमाल करता है।

ग्राहक चेकआउट, भुगतान लिंक और निर्धारित ईमेल अंग्रेज़ी, जर्मन, स्पेनिश, ब्राज़ीलियाई पुर्तगाली, इतालवी, रूसी, सरलीकृत चीनी, फ़्रेंच, कोरियाई और जापानी का समर्थन करते हैं।

स्टोर → इनवॉइस → चेकआउट भाषा डिफ़ॉल्ट तय करता है। हर इनवॉइस या भुगतान टूल के लिए बदलें। ईमेल और दोबारा भेजे संदेश इनवॉइस की भाषा रखते हैं। आपका लिखा पाठ नहीं बदलता; मर्चेंट और ऑपरेटर कंसोल अंग्रेज़ी में रहते हैं।

आउटगोइंग ईमेल

सेटिंग्स → सिस्टम में, स्रोत IP पाबंदियों के नीचे, प्रदाता के सार्वजनिक होस्टनाम, लॉगिन, भेजने वाले और वैकल्पिक reply-to से SMTP सक्रिय करें। पोर्ट 465 पर TLS या 587 पर STARTTLS इस्तेमाल करें।

सहेजें, कनेक्शन टेस्ट करें, फिर खुद को टेस्ट ईमेल भेजें। प्रदाता के साथ SPF/DKIM सेट करें। SMTP स्वीकार होना इनबॉक्स में पहुँचने की गारंटी नहीं है।

निर्धारित अनुरोध सिस्टम SMTP इस्तेमाल करते हैं। सूचना चैनल भी इसे चुन सकते हैं; मौजूदा चैनल और ऑपरेटर निमंत्रण सेटिंग्स नहीं बदलतीं। केवल इंस्टॉलेशन एडमिन ये एन्क्रिप्टेड क्रेडेंशियल सँभालता है। ईमेल भेजना विफल हो तो स्पष्ट रूप से दोबारा भेजना पड़ता है।

सूचनाएँ और अलर्ट

घंटी आपका सूचना इनबॉक्स खोलती है। थीम के विकल्प सेटिंग्स मेनू में हैं।

चैनल और नियम सेट करें
  1. सेटिंग्स → सूचनाएँ और अलर्ट खोलें। कंसोल सूचनाएँ बिल्ट-इन हैं।
  2. ईमेल या Telegram के लिए चैनल जोड़ें, सत्यापन कोड भेजें और डालें। फिर चैनल सक्रिय करके अपने नियमों में चुनें।
  3. भुगतान अपवाद, असफल कॉलबैक, ट्रांसफ़र समस्या, कम गैस, देर से स्कैनिंग, कम क्रेडिट या असफल बैकअप के अलर्ट चुनें। निपटाए भुगतान के अलर्ट वैकल्पिक हैं।

दोहराए मुद्दे समूहित होते हैं। इतिहास 30 दिन रहता है; प्रोजेक्ट अनुमतियाँ लागू रहती हैं। अलर्ट पढ़ने से समस्या हल नहीं होती। लोगों के लिए अलर्ट, स्टोर IPN या वेबहुक की जगह नहीं लेते।

मार्केटप्लेस

प्रोजेक्ट → मार्केटप्लेस सक्रिय करें, स्टोर चुनें और स्वतंत्र रूप से सत्यापित गंतव्यों के साथ विक्रेता दर्ज करें। सटीक विक्रेता हिस्सों वाला एक इनवॉइस बनाएँ; भुगतान खुद मंज़ूर करें या सीमित ऑटोमैटिक नीतियाँ तय करें।

कई विक्रेताओं के लिए भुगतान सेट करें

केवल Bitcoin मेननेट और समर्थित EVM कॉइन/ERC-20। ग्राहक पहले प्रोजेक्ट-नियंत्रित वॉलेट को भुगतान करते हैं, सीधे विक्रेताओं को नहीं। शुल्क के लिए अलग उपलब्ध नेटिव कॉइन रखें। सामान्य स्वीप सुरक्षित प्राप्ति पतों को छोड़ते हैं।

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

कई विक्रेताओं के लिए भुगतान सेट करें · मार्केटप्लेस API संदर्भ

लेखांकन

रिपोर्ट, ट्रांज़ैक्शन, एक्सपोर्ट और जाँच के लिए सेटिंग्स → लेखांकन खोलें। डैशबोर्ड अलग रहता है।

लेखाकार की रिपोर्ट तैयार करें
  1. अवधि, रिपोर्टिंग मुद्रा और समय क्षेत्र चुनें। प्रोजेक्ट या स्टोर से फ़िल्टर करें, फिर इनवॉइस, ऑर्डर, एसेट या ट्रांज़ैक्शन संदर्भ खोजें।
  2. जाँच में गुम दरों, शुल्क और भुगतान अपवादों की समीक्षा करें। विवरण मौजूदा इनवॉइस या ट्रांसफ़र से जुड़ते हैं।
  3. प्रिंट करने योग्य सार और विस्तृत CSV फ़ाइलों वाला लेखाकार ZIP डाउनलोड करें। हर डाउनलोड में 10,000 रिकॉर्ड तक; बड़े इतिहास के लिए छोटी अवधि चुनें।

पुष्टि की गई प्राप्तियाँ, रिफ़ंड और दर्ज खर्च वॉलेट ट्रांसफ़र व प्रीपेड क्रेडिट खरीद से अलग हैं। कई भुगतान होने पर भी इनवॉइस कुल एक बार गिने जाते हैं।

ऐतिहासिक मूल्य सुरक्षित प्रमाण इस्तेमाल करते हैं, आज की कीमतें नहीं। पुरानी दरें और असली शुल्क उपलब्ध न हों; गुम खर्च को कभी शून्य नहीं माना जाता। अधूरे प्रमाण पर शुद्ध कुल उपलब्ध नहीं रहता।

इसमें Wholly Crypto से ट्रैक किए रिकॉर्ड हैं, हर बाहरी वॉलेट या एक्सचेंज ट्रांज़ैक्शन नहीं। यह हिसाब रखने में मदद है, टैक्स रिटर्न या लाभ विवरण नहीं। एक्सपोर्ट सुरक्षित साझा करें: इनमें ग्राहक ईमेल हो सकते हैं।

स्वीप

प्राप्त फंड अपने चुने गंतव्य पर भेजें। नियम और इतिहास यहाँ सँभालें: प्रोजेक्ट → स्वीप.

नेटिव कॉइन भेजें: 29 चेन पर; Monero केवल देखने तक सीमित है। टोकन: सत्यापित ERC-20 और क्लासिक SPL। मैनुअल भेजना और ऑटोमैटिक स्वीप वही सुरक्षा उपाय इस्तेमाल करते हैं।

मैनुअल भेजना: तैयार करें, समीक्षा करें, मंज़ूर करें

BTC, EVM, SOL और TRX के साथ 18 नेटिव एडेप्टर हैं। भेजने की क्षमता वाला प्रदाता इस्तेमाल करें। ZEC केवल पारदर्शी है; ADA टोकन वाले आउटपुट बचाता है; DOT Asset Hub इस्तेमाल करता है; HBAR को रिले चाहिए। बाहर भेजते समय memo/tag/comment ज़रूरी हो तो बाहरी वॉलेट चाहिए।

  1. खोलें: प्रोजेक्ट → वॉलेट → एसेट → भेजें। पता पुस्तिका से प्रविष्टि चुनें या गंतव्य डालें। पूरा पता और नेटवर्क जाँचें।
  2. सटीक राशि या पूरा उपलब्ध स्वीप चुनें, फिर शुल्क स्तर। समर्थित टोकन के लिए, गैस के लिए प्रोजेक्ट ETH इस्तेमाल करें (या चेन का नेटिव कॉइन) उसी प्रोजेक्ट/चेन से कम पड़े शुल्क भर सकता है।
  3. क्लिक करें: ट्रांसफ़र तैयार करें। स्रोत, गंतव्य, राशि, अधिकतम शुल्क और गैस आवंटन की समीक्षा करें। मंज़ूर करें और भेजें इस प्लान को अनुमति देता है; केवल तैयारी से कुछ नहीं भेजा जाता।

मंज़ूरी के बाद गैस फंडिंग, पुष्टियाँ और टोकन भेजना बैकग्राउंड में जारी रहता है। देखें: ट्रांसफ़र गतिविधि, विंडो बंद करने के बाद भी। प्रसारण पुष्टि नहीं है।

प्रोजेक्ट वॉलेट में बचा ETH: 0 कोई रिज़र्व नहीं जोड़ता; यह आपका सारा ETH नहीं खर्च करता। 0.005 बाद के लिए कम से कम 0.005 ETH बचाता है, इसलिए इस वर्कफ़्लो के लिए अतिरिक्त फंड चाहिए। सहेजे ऑटोमैटिक नियम नहीं बदलते।

ऑटोमैटिक स्वीप सेटअप
  1. खोलें: ऑटोमैटिक स्वीप सेटअप → एसेट → सेटअप। वॉलेट पता या समर्थित एक्सचेंज गंतव्यचुनें, दोनों नहीं।
  2. स्वीप की न्यूनतम राशि और यह तय करें: न्यूनतम राशि रखें। उदाहरण: 100 USDC पर शुरू करें, 20 USDC रखें, अधिकतम 80 USDC भेजें। रिज़र्व पूरे प्रोजेक्ट के लिए है, हर पते के लिए नहीं।
  3. टोकन के लिए इसकी समीक्षा करें: गैस के लिए प्रोजेक्ट ETH इस्तेमाल करें और डालें: दैनिक फंडिंग सीमा। ऑटो स्वीप चालू करें, फिर नियम सहेजें और पुष्टि करें। केवल सेटअप खोलने से कुछ सक्रिय नहीं होता।

दैनिक सीमा हर टोकन नियम को पिछले लगातार 24 घंटों में आवंटित नेटिव गैस सीमित करती है। हल्के उपयोग के लिए €1 शुरुआती सीमा हो सकती है, तय खर्च या दैनिक शुल्क नहीं। फंडिंग ट्रांज़ैक्शन पर भी शुल्क लगता है। अधिकतम नेटवर्क शुल्क % मिलाकर फंडिंग/ट्रांसफ़र शुल्क सीमित कर सकता है।

जाँच अपने आप होती है। केवल योग्य टोकन वाले पतों को गैस मिलती है, खाली पतों को नहीं। कम फंड वाला पता स्वीप न्यूनतम से नीचे हो तो इंतज़ार करता है। गैस सीमाएँ समझें →

बेहतर तरीके और रुके ट्रांसफ़र
  • वॉलेट बैकअप लें और छोटा ट्रांसफ़र टेस्ट करें। नेटिव कॉइन खाली करने से पहले टोकन भेजें। प्रोजेक्ट में दूसरी जगह का ETH पहले हर टोकन पते तक पहुँचना चाहिए; बची गैस आपके वॉलेट में रहती है।
  • ताज़ा बैलेंस, स्वस्थ प्रदाता और पर्याप्त नेटिव फंड रखें। ऑटोमैटिक नियमों के लिए सक्रिय, बैकअप लिया वॉलेट और सक्रिय स्टोर में सक्रिय एसेट चाहिए। कम प्रोसेसिंग क्रेडिट भेजना रोक सकता है।
  • यहाँ: ट्रांसफ़र गतिविधिप्रगति, गैस फंडिंग और एक्सप्लोरर लिंक देखें। परिणाम अनिश्चित हो तो वही ट्रांसफ़र ताज़ा करें; नया न बनाएँ। कारण और सीमाएँ देखने के बाद ही जारी करें।

भेजना बंद है? जाँचें: whollycrypto transfers status। इससे पहले हर सक्रिय नियम देखें: whollycrypto transfers enable: यह पूरे सर्वर पर लागू होता है और सहेजे नियम तुरंत चला सकता है। अगले चरण रोकने से प्रसारित ट्रांज़ैक्शन वापस नहीं होते।

डोमेन

सेटिंग्स → सिस्टम: चुनें: प्रबंधन या डोमेन जोड़ें। सहेजें, DNS की समीक्षा करें, प्रकाशित करें। न बदले होस्ट DNS/SSL जाँच छोड़ते हैं।

स्टोर डोमेन

स्टोर → बेसिक: सक्रिय मर्चेंट/पे/API होस्ट चुनें। लिंक स्टोर → डिफ़ॉल्ट स्टोर → सिस्टम को प्राथमिकता देते हैं; हटे नाम पर वैकल्पिक नाम लेते हैं। SDK होस्ट अलग कॉन्फ़िगर करें। हस्ताक्षरित पुनः प्रयास मूल लिंक रखते हैं।

HTTPS अपने आप है। सेटअप के बाद Cloudflare बदलें; Let's Encrypt सक्रिय रहता है।

Cloudflare चेकलिस्ट
  • इस्तेमाल करें: Full (strict), Flexible नहीं; API कुंजी नहीं चाहिए।
  • कंसोल, चेकआउट और API के लिए कैशिंग और ब्राउज़र/बॉट चुनौती बंद करें।
  • अनुमति दें: /.well-known/acme-challenge/ नवीनीकरण के लिए पोर्ट 80 पर, बिना रीडायरेक्ट/चुनौती।

जाँच अधिकृत DNS से पूछती और origin सत्यापित करती है: सीधे या Cloudflare। आगंतुकों के पास पुराना DNS कैश हो सकता है।

5.6.2 से कंसोल सहेजना/हटाना POST इस्तेमाल करता है; “Not GET or POST” अपवाद नहीं चाहिए। लॉगिन और CSRF चालू हैं। यहाँ: api.*सार्वजनिक API के दस्तावेज़ में दिए मेथड की अनुमति दें।

खाते की सुरक्षा

2FA यहाँ सेट करें: सेटिंग्स → खाता। केवल प्रोजेक्ट वाले उपयोगकर्ता इस्तेमाल करें: मेरी सुरक्षा फ़ुटर में। पासवर्ड की पुष्टि करें, TOTP QR/कुंजी स्कैन करें और छह अंकों का कोड डालें।

आज़माएँ: Verifyr Authenticator इनके लिए: iOS या Android, या दूसरा मानक TOTP ऐप। एक बार इस्तेमाल वाले रिकवरी कोड पासवर्ड से अलग रखें। HTTP Basic सुरक्षा चालू रखें।

रिकवरी और रूप

कोड बदलने या 2FA बंद करने के लिए पासवर्ड और ऑथेंटिकेटर या इस्तेमाल न हुआ रिकवरी कोड चाहिए। दूसरे सत्र बंद होते हैं। फ़ोन/सर्वर की घड़ियाँ मिलाकर रखें; 2FA हैक हो चुके सर्वर को सुरक्षित नहीं बनाता।

थीम आइकन क्रम से बदलता है: हल्का → मंद → गहरा और इस ब्राउज़र की पसंद याद रखता है। स्टोर चेकआउट थीम अलग हैं।

सर्वर सुरक्षा

  • SSH कुंजियाँ इस्तेमाल करें और SSH विश्वसनीय IP तक सीमित करें। जाँचा हुआ रिकवरी कनेक्शन रखें।
  • सेटअप के बाद Full (strict) के साथ Cloudflare प्रॉक्सी चालू करें।
  • यहाँ: सेटिंग्स → सिस्टम → स्रोत IP पाबंदियाँमें विश्वसनीय IP/रेंज की अनुमति दें, हर लाइव merchant.* या api.* होस्टनाम के लिए। वर्तमान कंसोल IP की अनुमति बनी रहनी चाहिए।
  • आमतौर पर इसे रखें: pay.* खुला: ग्राहकों को कहीं से भी भुगतान करना होता है।
Cloudflare और लॉकआउट रिकवरी

चाहें तो Cloudflare पहुँच नियम जोड़ें। HTTPS नवीनीकरण चुनौतियों को छूट दें; API और चेकआउट पर इंटरैक्टिव लॉगिन चुनौती न लगाएँ। केवल प्रॉक्सी मोड IP पाबंदी नहीं है।

पहुँच बंद हो गई? चलाएँ: whollycrypto access-reset --domain merchant.example.com SSH पर। पाँच सेकंड के भीतर केवल वही होस्टनाम फिर खुलता है; खाता प्रमाणीकरण चालू रहता है।

HTTPS ठीक करें

whollycrypto ssl
whollycrypto ssl --fix

पहली कमांड सक्रिय सर्टिफ़िकेट जाँचती है। --fix TLS सहायक फ़ाइलें ठीक करता है और गायब/जल्द समाप्त सर्टिफ़िकेट नवीनीकृत करता है। Nginx चलना चाहिए; 80/443 पोर्ट खुले रखें।

एक सर्टिफ़िकेट दोबारा जारी करें

चलाएँ: whollycrypto ssl --domain merchant.example.com --reissue ज़बरन बदलने के लिए। जारी करने की सीमाएँ लागू हैं। Cloudflare HTTP चुनौती रोके तो अस्थायी रूप से केवल DNS करें। वॉलेट, प्रमाणीकरण और डोमेन नहीं बदलते।

रोज़ की जाँच

  • इस अनुभाग में: ध्यान देने की ज़रूरतसमीक्षित चिह्नित करने, नोट जोड़ने या फिर स्कैन करने के लिए इनवॉइस या वर्तमान पेज चुनें। वित्तीय फैसले अलग-अलग रहते हैं।
  • डिस्क जगह, स्कैनर देरी और स्वतंत्र वैकल्पिक नोड देखें। सार्वजनिक एंडपॉइंट क्षमता की गारंटी नहीं देते।
  • Linux अपडेट रखें, SSH सीमित करें और उपयोगकर्ताओं/API कुंजियों को ज़रूरी प्रोजेक्ट व अनुमतियों तक बाँधें।

फैसलों का कारण चाहिए। रिफ़ंड के लिए अलग पुष्टि किया ट्रांसफ़र चाहिए; इनवॉइस स्थिति बदलने से पैसे नहीं भेजे जाते।

अपडेट और बैकअप

पढ़ें: रिलीज़ नोट, फिर इस्तेमाल करें: सेटिंग्स → सिस्टम → सॉफ़्टवेयर अपडेट या CLI। अपडेट हस्ताक्षर सत्यापित करते, बैकअप बनाते और स्वास्थ्य जाँचते हैं। इंस्टॉलेशन में चेकआउट रुकता है।

whollycrypto update --check
whollycrypto update

अपडेट बैकग्राउंड काम के लिए दो मिनट तक इंतज़ार करते हैं; चेकआउट ऑनलाइन रहता है। टाइमआउट पर टाइमर बहाल होते हैं।

0.1.31 या पहले से अपग्रेड करना

पुराना अपडेटर अटका है? यह एक बार चलाएँ। आपकी इंस्टॉल की कुंजी हेल्पर सत्यापित करती है।

bash <(curl -fsSL https://releases.whollycrypto.com/update_wholly.sh)

जाँचे हुए रखें: सर्वर से बाहर बैकअप PostgreSQL, कॉन्फ़िगरेशन, वॉलेट एन्क्रिप्शन कुंजियों और वॉलेट एक्सपोर्ट के। स्थानीय रिकवरी आर्काइव एन्क्रिप्टेड नहीं होते।

मेल खाते डेटाबेस/कॉन्फ़िगरेशन बैकअप साथ रीस्टोर करें। माइग्रेशन बीच में न रोकें या नए डेटाबेस पर पुरानी बाइनरी न चलाएँ। क्रेडिट नियम फिर भी लागू हैं।

GitHub डाउनलोड विकल्प

सेटअप और अपडेट अपने आप यह आज़माते हैं: आधिकारिक GitHub मिरर। हस्ताक्षर, चेकसम और क्रेडिट जाँच ज़रूरी रहती हैं।

सर्वर CLI

SSH पर root कमांड।

whollycrypto status
whollycrypto doctor
whollycrypto backup
सभी कमांड
कमांडउद्देश्य
whollycrypto versionइंस्टॉल किया संस्करण।
whollycrypto statusऐप और डेटाबेस स्वास्थ्य।
whollycrypto logsऐप लॉग की आखिरी 80 पंक्तियाँ।
whollycrypto restartरीस्टार्ट और स्वास्थ्य जाँच।
whollycrypto doctorकेवल पढ़ने वाली इंस्टॉलेशन जाँच।
whollycrypto doctor --fixप्रबंधित अनुमतियाँ और गायब CLI लिंक ठीक करें।
whollycrypto htaccessBasic Auth लॉगिन रीसेट करें।
whollycrypto admin-resetएडमिन पासवर्ड रीसेट करें।
whollycrypto 2fa-resetपासवर्ड बदले बिना एक खाते का ऑथेंटिकेटर रीसेट करें।
whollycrypto transfers status
whollycrypto transfers enable
whollycrypto transfers disable
सभी प्रोजेक्ट के लिए भेजने की स्थिति जाँचें, सक्रिय करें या रोकें। सक्रिय करने से ऐप रीस्टार्ट होता है और सहेजे नियम तुरंत चल सकते हैं; पुष्टि चाहिए। अपडेट रुकी स्थिति बनाए रखते हैं।
whollycrypto sslHTTPS जाँचें; जोड़ें: --fix ठीक करने के लिए।
whollycrypto access-reset --domain HOSTएक होस्टनाम की IP पाबंदी हटाएँ।
whollycrypto update --checkहस्ताक्षरित अपडेट जाँचें।
whollycrypto updateबैकअप लें, अपडेट और रीस्टार्ट करें।
whollycrypto backupकेवल root के लिए आर्काइव यहाँ: /root/whollycrypto/backups/releases/.
whollycrypto recoverरुका रखरखाव या अपरिवर्तित शैमा वाला अपडेट रिकवर करें। डेटाबेस अपने आप कभी रीस्टोर नहीं करता।
whollycrypto resetएक प्रोजेक्ट, सभी व्यवसाय प्रोजेक्ट या केवल मरम्मत चुनें।
whollycrypto uninstall --check
whollycrypto uninstall
पहले प्रीव्यू, फिर नेटिव रनटाइम हटाएँ। डेटाबेस, कुंजियाँ और बैकअप रहते हैं।
whollycrypto welcomeकंसोल URL और लिंक।
whollycrypto --helpकमांड; जोड़ें: --help किसी कमांड के बाद उसके विकल्पों के लिए।
इंस्टॉलेशन समस्याएँ पहचानें

जाँच केवल पढ़ती हैं; ध्यान चाहिए तो गैर-शून्य एग्ज़िट कोड मिलता है। --fix केवल प्रबंधित अनुमतियाँ और गायब CLI लिंक ठीक करता है। बिलिंग बदलता, डेटा हटाता या सेवाएँ रीस्टार्ट नहीं करता।

रीसेट का दायरा चुनें
whollycrypto reset
# Preview without changing anything:
whollycrypto reset --scope business --check
whollycrypto reset --scope project --project YOUR_PROJECT_IDENTIFIER --check

एक प्रोजेक्ट, सभी व्यवसाय प्रोजेक्ट या केवल मरम्मत चुनें। प्रोजेक्ट रीसेट चुने प्रोजेक्ट, स्टोर, वॉलेट रिकॉर्ड और भुगतान इतिहास स्थायी रूप से मिटाते हैं। केवल मरम्मत प्रबंधित अनुमतियाँ और CLI लिंक जाँचकर ठीक करती है।

पहले चुने प्रोजेक्ट बंद करें, खुले भुगतान/ट्रांसफ़र निपटाएँ और ज्ञात वॉलेट बैलेंस हटाएँ। खाते, डोमेन, नोड, क्रेडिट, बिलिंग पहचान और इंस्टॉलेशन मोड रहते हैं। ऑपरेटर प्राप्ति वॉलेट और होस्टेड क्रेडिट रिकॉर्ड सुरक्षित हैं। यह सेटअप विज़ार्ड दोबारा नहीं खोलता।

डेटा मिटाने वाले रीसेट में लिखकर पुष्टि चाहिए और मिटाने से पहले सत्यापित रिकवरी बैकअप बनता है। सर्वर से बाहर वॉलेट बैकअप भी रखें: पुराने पते फंड पा सकते हैं, लेकिन हटे प्रोजेक्ट उन्हें ट्रैक नहीं करते। कैश बैलेंस वॉलेट खाली होने का प्रमाण नहीं हैं।

नेटिव इंस्टॉलेशन हटाएँ
whollycrypto uninstall --check
whollycrypto uninstall

चेकआउट, API और वर्कर रोकता है; बैकअप और लिखकर पुष्टि के बाद रनटाइम फ़ाइलें व प्रबंधित सर्वर इंटीग्रेशन हटाता है। लंबित भुगतान या ट्रांसफ़र हटाना रोकते हैं। फ़ाइलें मिटने के बजाय रिकवरी बैकअप में जाती हैं।

डेटाबेस, कॉन्फ़िगरेशन, कुंजियाँ और बैकअप रहते हैं। साझा Nginx/PostgreSQL पैकेज और TLS सर्टिफ़िकेट नहीं छुए जाते। कमांड ऑफ़लाइन रिकवरी कमांड दिखाती है; बचे डेटा के ऊपर नया सेटअप न चलाएँ।

रीसेट/हटाने की कमांड नेटिव VPS इंस्टॉलेशन के लिए हैं, Docker या Umbrel के लिए नहीं। कंटेनर में अपने इंटीग्रेशन की बैकअप और स्टॉप कमांड इस्तेमाल करें; वॉल्यूम रखें। दोनों डेटा मिटाने वाली कमांड यह स्वीकार नहीं करतीं: --yes.

Basic Auth लॉगिन रीसेट करें
whollycrypto htaccess

उपयोगकर्ता चुनें, नाम/पासवर्ड चुनकर पुष्टि करें। यह ब्राउज़र का पहला लॉगिन प्रॉम्प्ट रीसेट करता है, कंसोल खाता नहीं। दूसरे उपयोगकर्ता और API क्रेडेंशियल नहीं बदलते।

एडमिन पासवर्ड रीसेट करें
whollycrypto admin-reset

ईमेल से एडमिन चुनें और नए पासवर्ड की पुष्टि करें। सत्र और खाता लॉगिन लॉक साफ़ होते हैं; IP पाबंदियाँ रहती हैं।

सामान्य रीसेट 2FA रखते हैं। ऑथेंटिकेटर और रिकवरी कोड दोनों खो गए हों तो स्पष्ट रूप से चलाएँ: whollycrypto admin-reset --email admin@example.com --reset-2fa। लॉगिन के बाद 2FA फिर सेट करें।

डेटाबेस चाहिए, ऐप या पुराना पासवर्ड नहीं। दूसरे खाते, वॉलेट और अनुमतियाँ नहीं बदलते; निष्क्रिय खाते निष्क्रिय रहते हैं।

2FA रीसेट करें

ऑथेंटिकेटर और रिकवरी कोड दोनों खो गए? root के रूप में खाता चुनें।

whollycrypto 2fa-reset
# Or select the account directly:
whollycrypto 2fa-reset --email user@example.com

सत्र, ऑथेंटिकेटर और रिकवरी कोड हटाता है। मौजूदा पासवर्ड से लॉगिन करके 2FA फिर सेट करें। अनुमतियाँ, वॉलेट और Basic Auth नहीं बदलते; निष्क्रिय खाते निष्क्रिय रहते हैं।

डेटाबेस चाहिए, ऐप या क्रेडिट नहीं। गैर-इंटरैक्टिव: --email और --yes.

बनाए गए पासवर्ड और ऑटोमेशन

Enter यहाँ पासवर्ड बनाता है: /root/whollycrypto/config/credential-resets/: निजी, बिना एन्क्रिप्शन, सफलता के बाद इस्तेमाल योग्य। खुद डाले पासवर्ड सहेजे नहीं जाते।

whollycrypto htaccess --user admin --new-user operator
whollycrypto admin-reset --email admin@example.com

टर्मिनल के बिना मौजूदा खाते के साथ यह दें: --generate या --password-file /root/private-password.txt, और --yes। पासवर्ड फ़ाइलें root की होनी चाहिए, मोड 600। पासवर्ड कभी कमांड या पर्यावरण वेरिएबल में न डालें।

--yes केवल पुष्टि छोड़ता है। पहले रुके अपडेट की रिकवरी पूरी करें; साथ में खाता बदलने पर रीसेट रुकते हैं।