Shopify कस्टम ऐप

एकीकरण मॉडल

Shopify एकीकरण Shopify V2 देव डैशबोर्ड ऐप प्रवाह का उपयोग करता है। व्यापारी एक बार Shopify पार्टनर CLI टोकन प्रदान करता है ताकि MakeCrypto Shopify CLI के साथ Shopify देव डैशबोर्ड में निश्चित MakePay ऐप बना सके। MakeCrypto जेनरेट की गई क्लाइंट आईडी को स्वचालित रूप से पढ़ता है। Shopify अभी भी क्लाइंट रहस्य को केवल देव डैशबोर्ड के अंदर ही प्रकट करता है, इसलिए व्यापारी तैनाती से पहले उस रहस्य को MakeCrypto में कॉपी कर लेता है।

ऐप तैनात और इंस्टॉल होने के बाद, Shopify एक हस्ताक्षरित सत्र टोकन के साथ MakeCrypto लॉन्च करता है। MakeCrypto क्लाइंट सीक्रेट के साथ उस टोकन को मान्य करता है और इसे ऑफ़लाइन एडमिन API टोकन के लिए एक्सचेंज करता है। उस टोकन को आराम से एन्क्रिप्ट किया गया है और पहले की तरह उसी MakePay ऑर्डर वर्कफ़्लो के लिए उपयोग किया जाता है: ऑर्डर सिंक, होस्टेड भुगतान लिंक, नोट्स/टैग, webhooks, और वैकल्पिक मार्क-पेड ऑटोमेशन।

लीगेसी एडमिन API एक्सेस टोकन सेटअप अब नए Shopify कनेक्शन के लिए समर्थित नहीं है। उस पुराने प्रवाह से जुड़े मौजूदा स्टोर को V2 सेटअप के माध्यम से फिर से जुड़ना होगा।

Shopify देव डैशबोर्ड ऐप

MakeCrypto पार्टनर CLI टोकन से स्वचालित रूप से देव डैशबोर्ड ऐप बनाता है। ऐप का नाम हमेशा MakePay होता है। निर्माण के बाद, देव डैशबोर्ड में MakePay ऐप सेटिंग खोलें और क्लाइंट सीक्रेट को MakeCrypto में कॉपी करें।

आवश्यक एडमिन API स्कोप:

• read_customers
• write_customers
• read_products
• write_products
• read_orders
• write_orders
• read_draft_orders
• write_draft_orders
• read_themes
• write_themes

तैनात Shopify ऐप का नाम हमेशा MakePay होता है।

MakeCrypto सेटअप

MakeCrypto खोलें, कंपनी चुनें, फिर ई-कॉमर्स > Shopify पर जाएं। इसके साथ एक स्टोर जोड़ें:

• Shopify स्टोर स्लग, जो .myshopify.com से पहले का हिस्सा है
• एक बार का Shopify पार्टनर सीएलआई टोकन
• Shopify क्लाइंट रहस्य, MakeCrypto ऐप बनाने के बाद कॉपी किया गया
• मैन्युअल भुगतान विधि का नाम

पार्टनर सीएलआई टोकन तब तक एन्क्रिप्ट किया जाता है जब तक MakeCrypto ऐप बनाता, तैनात और इंस्टॉल नहीं करता है, फिर इसे साफ़ कर दिया जाता है। ऐप निर्माण के दौरान, MakeCrypto टोकन से Shopify देव डैशबोर्ड संगठन आईडी का भी पता लगाता है। क्लाइंट सीक्रेट और ऑफ़लाइन एडमिन API टोकन बाकी समय एन्क्रिप्टेड हैं।

पार्टनर सीएलआई टोकन जेनरेट करने के लिए, Shopify पार्टनर पोर्टल सेटिंग्स खोलें, सीएलआई टोकन तक स्क्रॉल करें, टोकन प्रबंधित करें और एक नया टोकन जेनरेट करें। MakePay ऐप इंस्टॉलेशन सफल होने के बाद इसे रद्द किया जा सकता है।

स्थापित करें और checkout ब्लॉक

जब परिनियोजन परिनियोजित के रूप में दिखाई दे, तो Shopify पार्टनर पोर्टल खोलें, ऐप चुनें, वितरण > कस्टम वितरण पर जाएं, और स्टोर पर ऐप इंस्टॉल करें। स्थापना के बाद Shopify वापस MakeCrypto पर रीडायरेक्ट हो जाता है।

फिर Shopify एडमिन खोलें और सेटिंग्स > चेकआउट > कस्टमाइज़ पर जाएं। MakePay ब्लॉक को धन्यवाद पृष्ठ और ऑर्डर स्थिति पृष्ठ पर जोड़ें, फिर सहेजें।

MakePay ब्लॉक Shopify के सत्र टोकन को सत्यापित करता है, मिलान भुगतान लिंक के लिए MakeCrypto पूछता है, और अभी भुगतान करें बटन प्रदर्शित करता है। यदि ऑर्डर webhook अभी भी संसाधित किया जा रहा है, तो ब्लॉक थोड़ी देर प्रतीक्षा करता है जबकि MakePay लिंक तैयार करता है।

मैन्युअल भुगतान विधि

Shopify एडमिन में, सेटिंग्स > भुगतान > मैन्युअल भुगतान विधियां खोलें और एक कस्टम भुगतान विधि बनाएं। इसका नाम बिल्कुल MakeCrypto कनेक्शन भुगतान विधि के नाम से मेल खाना चाहिए। नए MakePay कनेक्शन डिफ़ॉल्ट रूप से:

Crypto Payment in USDT, BTC, ETH, LTC, DOGE and others

जब ग्राहक वह तरीका चुनते हैं, तो Shopify ऑर्डर को अवैतनिक बना देता है। MakePay सिंक होस्टेड checkout URL को ऑर्डर नोट से जोड़ता है और सक्षम होने पर MakePay भुगतान अनुरोध ईमेल भेज सकता है।


वेबहुक और सिंक

MakeCrypto ऑर्डर बनाने/अपडेट करने के लिए रजिस्टर करता है और V2 इंस्टॉल पूरा होने के बाद ऐप webhooks को अनइंस्टॉल करता है। एक शेड्यूल किया गया सिंक हाल ही में कनेक्टेड स्टोर्स की भी जांच करता है, इसलिए यदि Shopify webhook डिलीवरी में देरी हो रही है, तब भी ऑर्डर उठाए जाते हैं।

पेलोड स्वीकार करने से पहले आने वाले Shopify webhook हस्ताक्षर सत्यापित किए जाते हैं। समस्या निवारण के लिए अनुरोध और webhook लॉग को कनेक्शन पृष्ठ पर रखा जाता है।

स्थिति मानचित्रण

जब Shopify ऑर्डर MakePay मैन्युअल भुगतान विधि के माध्यम से लंबित है, तो MakePay ऑर्डर कुल और ग्राहक ईमेल के लिए MakePay भुगतान लिंक बनाता है या पुन: उपयोग करता है।

जब MakePay भुगतान complete तक पहुंचता है, तो MakePay एक भुगतान नोट/टैग जोड़ता है और ऑटो-मार्क-पेड सक्षम होने पर Shopify एडमिन API orderMarkAsPaid का उपयोग करता है।

जब MakePay भुगतान failed, expired, या cancelled तक पहुंचता है, तो MakePay एक स्थिति नोट जोड़ता है और Shopify ऑर्डर को व्यापारी की समीक्षा के लिए अवैतनिक छोड़ देता है।

समस्या निवारण

यदि ऐप निर्माण या तैनाती विफल हो जाती है, तो पुष्टि करें कि पार्टनर सीएलआई टोकन atkn_ से शुरू होता है और काम शुरू होने से पहले रद्द नहीं किया गया है, फिर MakeCrypto से पुनः प्रयास करें।

यदि इंस्टॉल विफल हो जाता है, तो पुष्टि करें कि Shopify ऐप उसी MakeCrypto सेटअप द्वारा बनाया गया था और MakeCrypto का जेनरेट किया गया ऐप URL परिनियोजन द्वारा कॉन्फ़िगर किया गया है।

यदि परीक्षण कनेक्शन विफल हो जाता है, तो सत्यापित करें कि ऐप में सभी आवश्यक दायरे हैं और ऐप को पुनः इंस्टॉल या पुनः तैनात करें।

यदि पे नाउ ब्लॉक तैयारी की स्थिति में रहता है, तो पुष्टि करें कि MakePay ब्लॉक दोनों checkout पृष्ठों पर स्थापित है और Shopify ऑर्डर सटीक मैन्युअल भुगतान विधि नाम का उपयोग करता है।