क्रिप्टोकरेंसी पेमेंट गेटवे API: इंटीग्रेशन गाइड

क्रिप्टो पेमेंट गेटवे API क्या करती है?

API ब्लॉकचेन को आपके कोड से छिपा देती है। नोड चलाने, पते बनाने और कन्फ़र्मेशन गिनने के बजाय आप इनवॉइस बनाने के लिए एक एंडपॉइंट कॉल करते हैं, गेटवे की आईडी सहेजते हैं और सूचनाओं का इंतज़ार करते हैं। गेटवे विनिमय दर बताता है, नेटवर्क पर नज़र रखता है, AML स्क्रीनिंग लागू करता है और आपके बैलेंस में सेटल करता है।

अधिकांश गेटवे वही बुनियादी हिस्से अलग-अलग नामों से देते हैं: आने वाले पेमेंट के लिए इनवॉइस या ऑर्डर, सूचनाओं के लिए IPN या callback, कन्वर्ज़न और बैलेंस एंडपॉइंट, और बाहर जाने वाले ट्रांसफर के लिए पेआउट या निकासी। अधिकांश प्रोवाइडर के पास सैंडबॉक्स होते हैं, जैसे CoinGate पर अलग sandbox होस्ट और NOWPayments पर sandbox खाता, और किसी भी मेननेट टेस्ट से पहले इनका उपयोग होना चाहिए।

Invoice API: फ़िएट कीमत, स्वीकृत कॉइन, ऑर्डर संदर्भ और callback URL के साथ पेमेंट अनुरोध बनाना, पढ़ना और रद्द करना
सूचनाएँ: हर स्टेटस परिवर्तन पर webhook या IPN, आमतौर पर हस्ताक्षरित
Payouts API: ग्राहकों, भागीदारों या आपके अपने वॉलेट को क्रिप्टो या फ़िएट भेजना
दरें और मुद्राएँ: समर्थित कॉइन, नेटवर्क, न्यूनतम राशि और लाइव कोट सूचीबद्ध करना
प्लगइन और SDK: उसी API के ऊपर ई-कॉमर्स प्लेटफ़ॉर्म के लिए तैयार मॉड्यूल

इनवॉइस जीवनचक्र कैसे काम करता है?

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

तालिका दो प्रकाशित स्टेटस मॉडल को उन अवस्थाओं से जोड़ती है जो अधिकांश प्लेटफ़ॉर्म को चाहिए। उदाहरण के लिए CoinGate, खरीदार के कॉइन चुनने के 20 मिनट बाद अदत्त इनवॉइस की समय-सीमा समाप्त कर देता है, और AML जाँच में चिह्नित पेमेंट को invalid चिह्नित करता है।

गेटवे स्टेटस का आंतरिक अवस्थाओं से मैपिंग
आंतरिक अवस्था	CoinGate API v2	NOWPayments	आपके सिस्टम में कार्रवाई
बनाया गया	new	waiting	पेमेंट पेज दिखाएँ, टाइमर शुरू करें
पहचाना गया	pending, confirming	confirming, confirmed, sending	प्रतीक्षा स्क्रीन दिखाएँ, शिप न करें
भुगतान-पूर्ण	paid	finished	ऑर्डर पूरा करें, सेटलमेंट दर्ज करें
आंशिक	प्रकाशित सूची में अलग स्टेटस नहीं	partially_paid	अंतर माँगें या रिफ़ंड करें
विफल	invalid, expired, canceled	failed, expired	स्टॉक मुक्त करें, नया प्रयास करने दें
रिफ़ंड किया गया	refunded, partially_refunded	refunded	ऑर्डर और अकाउंटिंग अपडेट करें

क्रिप्टो webhook और IPN का सत्यापन कैसे करें?

हर सूचना को सत्यापित होने तक अविश्वसनीय मानें। गेटवे अलग-अलग तरीके अपनाते हैं: NOWPayments क्रमबद्ध JSON बॉडी को HMAC-SHA512 से हस्ताक्षरित करके x-nowpayments-sig हेडर में भेजता है, CoinGate ऑर्डर पर आपके द्वारा तय किया गया टोकन भेजता है, और BitPay बॉडी पर भरोसा करने के बजाय हर सूचना के बाद API से इनवॉइस मँगाने की सलाह देता है।

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

हस्ताक्षर की जाँच constant-time तुलना से करें और बिना हस्ताक्षर वाले अनुरोध अस्वीकार करें
ऑर्डर की अवस्था बदलने से पहले गेटवे ID से इनवॉइस दोबारा मँगाएँ
HTTP 200 जल्दी लौटाएँ और असिंक्रोनस रूप से प्रोसेस करें; त्रुटि पर गेटवे रीट्राई करते हैं
हर सूचना को उसके इवेंट या स्टेटस के साथ सहेजें ताकि डुप्लिकेट अनदेखे हो जाएँ
ब्राउज़र रीडायरेक्ट में भेजी गई राशि या मुद्रा पर कभी भरोसा न करें

कम-भुगतान, अधिक-भुगतान और देर से भुगतान को कैसे संभालें?

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

आम सीमांत स्थितियाँ और सामान्य संचालन
स्थिति	ऑन-चेन क्या होता है	सामान्य संचालन
कम-भुगतान	बताई गई राशि से कम आती है	छोटी सहनशीलता में स्वीकार करें, शेष माँगें, या रिफ़ंड करें
अधिक-भुगतान	बताई गई राशि से अधिक आती है	भुगतान-पूर्ण चिह्नित करें, अनुरोध पर अधिशेष क्रेडिट या रिफ़ंड करें
देर से भुगतान	दर-लॉक समाप्त होने के बाद राशि आती है	वर्तमान दर पर नया कोट दें या रिफ़ंड करें
गलत नेटवर्क	टोकन असमर्थित चेन पर भेजा गया	संभव हो तो मैन्युअल रिकवरी, अक्सर शुल्क पर
AML होल्ड	स्रोत वॉलेट स्क्रीनिंग में चिह्नित	पेमेंट रोका या invalid चिह्नित, कम्प्लायंस समीक्षा

idempotency और रीकंसिलिएशन कैसे काम करते हैं?

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

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

ट्रैवल रूल के तहत पेआउट API को क्या चाहिए?

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

EU में Regulation (EU) 2023/1113 गेटवे से हर ट्रांसफर के साथ प्रेषक और लाभार्थी की जानकारी भेजने और EUR 1,000 से ऊपर सेल्फ़-होस्टेड वॉलेट के स्वामित्व की पुष्टि करने की माँग करता है। अपेक्षा रखें कि पेआउट अनुरोधों में लाभार्थी का नाम और पते का प्रकार शामिल होगा, और ऐसे ट्रांसफर की योजना बनाएँ जो इस डेटा के लिए रुकते हैं।

व्हाइट-लेबल क्रिप्टो पेमेंट गेटवे के विकल्प क्या हैं?

जो प्लेटफ़ॉर्म अपने मर्चेंट को पेमेंट दोबारा बेचते हैं, वे अक्सर पेमेंट पेज अपने ब्रांड में चाहते हैं। इसके तीन स्तर हैं, और नियंत्रण के साथ कीमत बढ़ती है। उदाहरण के लिए Plisio API के लिए 0.5% और व्हाइट लेबल के लिए 1.5% बताता है, और NOWPayments अलग व्हाइट-लेबल उत्पाद बेचता है।

पूर्ण व्हाइट लेबल ब्रांडिंग के साथ ज़िम्मेदारी भी बदल देता है। यदि आप मर्चेंट ऑनबोर्ड करते हैं और उनके बैलेंस रखते हैं, तो आपको अपना MiCA प्राधिकरण चाहिए हो सकता है; अधिकृत गेटवे का सब-मर्चेंट मॉडल इस्तेमाल करने से यह दायित्व गेटवे के पास रहता है।

व्हाइट-लेबल मॉडल
मॉडल	ब्रांडिंग	मर्चेंट कौन ऑनबोर्ड करता है	आप पर नियामकीय बोझ
लोगो के साथ होस्टेड इनवॉइस	गेटवे का पेज, आपका लोगो	गेटवे	कम
गेटवे API पर अपना UI	पूरी तरह आपका	गेटवे, प्रति मर्चेंट खाता	कम से मध्यम
व्हाइट-लेबल प्लेटफ़ॉर्म	पूरी तरह आपका, अपना डैशबोर्ड	आप	अधिक, CASP प्राधिकरण ज़रूरी हो सकता है

OrsunPay के माध्यम से क्रिप्टो गेटवे API कैसे जोड़ें

OrsunPay आपके अपने गेटवे खातों के साथ, आपके कार्ड और बैंक प्रोवाइडरों के साथ-साथ क्रिप्टो गेटवे के स्टेटस, webhook और रिफ़ंड को एक API में सामान्यीकृत करता है। यह क्रिप्टो की कस्टडी नहीं रखता और अपने बैलेंस से पेआउट नहीं चलाता; यह अनुरोधों को आपके चुने गेटवे तक रूट करता है और हस्ताक्षरित, डुप्लिकेट-रहित इवेंट लौटाता है।

क्रिप्टोकरेंसी पेमेंट गेटवे API को कैसे इंटीग्रेट करें

सैंडबॉक्स खाते खोलें गेटवे पर सैंडबॉक्स और प्रोडक्शन खाते बनाएँ, इनवॉइस और पेआउट के लिए अलग API कुंजियाँ जनरेट करें, और IPN सीक्रेट सेट करें।
स्टेटस मैप करें गेटवे के स्टेटस को अपनी आंतरिक अवस्थाओं में बदलें और तय करें कि कौन-सा सामान जारी करता है।
इनवॉइस idempotent रूप से बनाएँ फ़िएट राशि, मुद्रा, ऑर्डर संदर्भ और callback URL भेजें; समय-समाप्त कॉल को दोबारा भेजने से पहले संदर्भ से खोजें।
सूचनाएँ सत्यापित करें हस्ताक्षर जाँचें, API से इनवॉइस दोबारा मँगाएँ और इवेंट को एक ही बार प्रोसेस करें।
सीमांत स्थितियाँ संभालें सहनशीलता, टॉप-अप, रिफ़ंड और समय-समाप्ति के प्रवाह बनाएँ, और हर एक को सैंडबॉक्स में टेस्ट करें।
सेटलमेंट का मिलान करें हर इनवॉइस के लिए ट्रांज़ैक्शन हैश, दर और शुल्क सहेजें और रोज़ पेआउट बैच को ऑर्डर से मिलाएँ।

अक्सर पूछे जाने वाले प्रश्न

क्रिप्टोकरेंसी पेमेंट गेटवे API क्या है?

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

व्हाइट-लेबल क्रिप्टो पेमेंट गेटवे क्या है?

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

मुझे कितने कन्फ़र्मेशन का इंतज़ार करना चाहिए?

यह गेटवे पर छोड़ें और उसके अंतिम paid स्टेटस पर कार्रवाई करें। गेटवे नेटवर्क और राशि के अनुसार कन्फ़र्मेशन सीमाएँ तय करते हैं, जिनमें गति और ब्लॉक के पुनर्गठन के जोखिम में संतुलन रखा जाता है।

मैं क्रिप्टो पेमेंट webhook का सत्यापन कैसे करूँ?

गेटवे द्वारा दिया गया हस्ताक्षर या टोकन जाँचें, फिर API से इनवॉइस मँगाएँ और उसी प्रतिक्रिया पर कार्रवाई करें। हर इवेंट को एक बार प्रोसेस करें और HTTP 200 जल्दी लौटाएँ।

क्या मैं अपना क्रिप्टो पेमेंट गेटवे खुद बना सकता हूँ?

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

क्या क्रिप्टो गेटवे सैंडबॉक्स देते हैं?

अधिकांश देते हैं। उदाहरण के लिए CoinGate और NOWPayments टेस्ट क्रेडेंशियल वाले सैंडबॉक्स वातावरण देते हैं, ताकि आप बिना असली धन के पूरा इनवॉइस और callback प्रवाह चला सकें।

OrsunPay को जानें

हमारी टीम से बात करें

स्रोत

CoinGate developer documentation: order statuses
EUR-Lex: Regulation (EU) 2023/1113 on information accompanying transfers of funds and crypto-assets
EUR-Lex: Regulation (EU) 2023/1114 on markets in crypto-assets (MiCA)
Plisio: pricing