भुगतान को इनवॉइस से जोड़ना और राशि का अंतर

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

इनवॉइस की स्थितियाँ, समय-सीमाएँ और स्थितियों के बीच बदलाव इनवॉइस का जीवनचक्र में बताए गए हैं।

राशि मेल खाने का नियम

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

भुगतान की राशि इनवॉइस की राशि से बिलकुल मेल खानी चाहिए। कोई छूट नहीं है। देय राशि स्टेबलकॉइन USDT और USDC के लिए 2 दशमलव स्थानों से और बाकी क्रिप्टोकरेंसी के लिए 8 दशमलव स्थानों से बनती है, और आने वाले भुगतान की तुलना उससे ठीक-ठीक होती है। कोई भी विचलन — कम भुगतान या अधिक भुगतान, चाहे कितना भी छोटा — अपने-आप जुड़ने को रोक देता है।

उदाहरण। 100.00 USD का इनवॉइस जारी होता है, जिसकी लॉक की हुई राशि 100.12 USDT है।

आने वाले भुगतान की राशि	नतीजा
100.12 USDT	इनवॉइस अपने-आप भुगतान हुआ (Paid) स्थिति में चला जाता है
100.11 USDT	अपने-आप नहीं जुड़ता
100.50 USDT	अपने-आप नहीं जुड़ता

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

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

राशि का अंतर होने पर क्या होता है

सेवा दर्ज करती है कि पैसा आया, लेकिन इनवॉइस पर कोई कार्रवाई नहीं करती:

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

सेवा में Partially paid या Overpaid जैसी बीच की स्थितियाँ नहीं हैं।

व्यापारी को समस्या का पता कैसे चलता है

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

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

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

बिना जुड़े भुगतान प्रोग्राम से भी खोजे जा सकते हैं। payments/list मेथड आपके सभी वॉलेट के भुगतान लौटाता है, और इनवॉइस से न जुड़े भुगतान के जवाब में invoice ब्लॉक नहीं होता। यही मैन्युअल जोड़ने के उम्मीदवार हैं: राशि और समय की तुलना अपेक्षित इनवॉइस से करें और invoices/bindPayment कॉल करें।

भुगतान को मैन्युअल रूप से जोड़ना

अगर आपको पक्का पता है कि कौन सा भुगतान किस इनवॉइस का है, तो उन्हें मैन्युअल रूप से जोड़ें — डैशबोर्ड में इनवॉइस के पृष्ठ पर या भुगतानों की सूची में, या API से invoices/bindPayment मेथड के ज़रिए।

जोड़ने की शर्तें

जोड़ना तभी संभव है, जब सारी शर्तें एक साथ पूरी हों:

1. इनवॉइस भुगतान बाकी या समय समाप्त स्थिति में है। रद्द और पहले से भुगतान हो चुके इनवॉइस से जोड़ा नहीं जा सकता।
2. भुगतान अभी किसी दूसरे इनवॉइस से जुड़ा नहीं है। एक भुगतान सिर्फ़ एक ही इनवॉइस से जुड़ सकता है।
3. भुगतान उस वॉलेट पर आया है, जो इस इनवॉइस में शामिल है।
4. भुगतान उपलब्ध भुगतान विंडो के भीतर है — इनवॉइस बनने से 24 घंटे पहले और 24 घंटे बाद तक।

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

जोड़ने के बाद क्या होता है

• इनवॉइस भुगतान हुआ स्थिति में चला जाता है — ठीक वैसे ही, जैसे अपने-आप जुड़ने पर।
• Webhook हमेशा भेजा जाता है। सूचना भुगतान हुआ स्थिति में हर बदलाव पर जाती है, चाहे जोड़ किसी भी तरह हुआ हो।
• USD में इनवॉइस की राशि असली भुगतान से दोबारा गिनी जाती है। amountFiatUSD फ़ील्ड में असल में मिली राशि लिख दी जाती है, जोड़ने के समय की विनिमय दर पर। amountFiat की मूल राशि नहीं बदलती।
• शुल्क असली राशि से दोबारा गिना जाता है। यह आपको मिली राशि पर प्रोजेक्ट की शुल्क दर से लगता है।