Shop Cash के लिए अपने सिस्टम तैयार करें

थर्ड-पार्टी सिस्टम के साथ Shop Cash वर्कफ़्लो लॉन्च करने से पहले, इन ज़रूरतों की पुष्टि करें:

• आपके ERP, OMS, फ़ुलफ़िलमेंट, अकाउंटिंग और रिटर्न सिस्टम एक ऑर्डर पर एक से ज़्यादा पेमेंट मेथड स्वीकार कर सकते हैं।
• जहाँ गेटवे वैल्यू उपलब्ध हैं, वहाँ shop_cash को पेमेंट मेथड के तौर पर मैप किया गया है।
• Shop Cash को छूट, गिफ़्ट कार्ड या स्टोर क्रेडिट के तौर पर नहीं माना जाता है।
• ऑथराइज़ेशन वैल्यू को कम से कम 1024 वर्णों की एक ओपेक (opaque) वैरिएबल-लेंथ स्ट्रिंग के रूप में स्टोर किया जाता है। अगर संभव हो, तो एक अनबाउंडेड टेक्स्ट फ़ील्ड का इस्तेमाल करें।
• कैप्चर, वॉइड और रिफ़ंड की पहचान ऑथराइज़ेशन वैल्यू के बजाय लेन-देन आईडी (transaction ID) से की जाती है। Admin API कैप्चर और वॉइड ऑपरेशन parentTransactionId का इस्तेमाल करते हैं, और रिफ़ंड ऑपरेशन parentId का इस्तेमाल करते हैं।
• आपके सिस्टम Shop Cash ऑथराइज़ेशन वैल्यू को पार्स, डिकोड, नॉर्मलाइज़, हैश या ट्रंकेट नहीं करते हैं।
• आपके सिस्टम ग्रुप किए गए पेआउट को हैंडल कर सकते हैं, जहाँ एक shop_cash_credit पंक्ति कई ऑर्डर को दर्शा सकती है।
• आपका लेखा मिलान प्रक्रिया वर्कफ़्लो यह मानकर नहीं चलता है कि एक ऑर्डर का मतलब एक पेआउट पंक्ति है।
• आपका लेखा मिलान प्रक्रिया वर्कफ़्लो Shop Cash हिस्से और कार्ड या Shop Pay Installments हिस्से को अलग-अलग पेआउट पर सेटल करने की प्रक्रिया को संभाल सकता है।
• आपका रिफ़ंड वर्कफ़्लो कार्ड या Shop Pay Installments और Shop Cash में आंशिक रिफ़ंड प्रोसेस कर सकता है।
• रिफ़ंड ऐप ऑथराइज़ेशन लेन-देन के बजाय Shop Cash कैप्चर लेन-देन का रिफ़ंड कर सकते हैं।
• अगर आपने जनवरी 2026 से पहले Shop Campaigns चलाया था, तो आपका फ़ाइनेंस वर्कफ़्लो ऐतिहासिक shop_cash_campaign_billing_debit और संबंधित कैम्पेन बिलिंग पंक्तियों को ऑर्डर से होने वाली आय (revenue) से अलग हैंडल करता है। जनवरी 2026 के बाद से कैम्पेन की लागत आपके Shopify बिल में ली जाएगी।

Shop Cash की टेस्टिंग की सीमाएं हैं क्योंकि Shop Cash, Shop खरीदार अकाउंट, Shop Cash बैलेंस, Shopify Payments और Shop Cash सेटलमेंट इन्फ़्रास्ट्रक्चर पर निर्भर करता है।

किसी एंटरप्राइज़ इंटीग्रेशन को शुरू से अंत तक (end to end) मान्य करने का सबसे भरोसेमंद तरीका Shop के ज़रिए कम वैल्यू वाला एक प्रोडक्शन ऑर्डर देना और फिर उसका रिफ़ंड करना है। इससे प्रोडक्शन जैसे ऑर्डर लेन-देन, कैप्चर डेटा, पेआउट एक्टिविटी, रिफ़ंड लेन-देन और रिफ़ंड डेबिट एक्टिविटी बनती है जो Shopify एडमिन, Admin API डेटा, पेआउट एक्सपोर्ट और पेआउट API डेटा के ज़रिए फ़्लो करती है।

डेवेलपमेंट स्टोर कुछ API फ़ील्ड के आकार और मैपिंग लॉजिक को मान्य करने में मदद कर सकते हैं, लेकिन वे पूरी तरह से Shop से शुरू हुए चेकआउट, खरीदार का बैलेंस और सेटलमेंट फ़्लो का ठीक से परीक्षण नहीं करते हैं। परीक्षण मोड और बोगस गेटवे (Bogus gateway) प्रोडक्शन जैसी Shop Cash पेआउट पंक्तियां नहीं बनाते हैं क्योंकि वे लाइव Shopify Payments सेटलमेंट फ़्लो का उपयोग नहीं करते हैं।

आप आम तौर पर Shop से शुरू किए गए कम वैल्यू वाले प्रोडक्शन ऑर्डर के साथ इन वर्कफ़्लो का टेस्ट कर सकते हैं:

• एक से ज़्यादा पेमेंट मेथड वाले ऑर्डर के लिए ऑर्डर इंजेशन (Order ingestion) जिसमें Shop Cash और Shop Pay या Shop Pay Installments शामिल हों।
• shop_cash के लिए ERP या OMS मैपिंग।
• पूरी Shop Cash ऑथराइज़ेशन वैल्यू का स्टोरेज।
• ऑर्डर के विरुद्ध पूरा और आंशिक रिफ़ंड।
• shop_cash_refund_debit पेआउट एक्टिविटी का इंजेशन।
• Shop Cash क्रेडिट के लिए पेआउट लेखा मिलान प्रक्रिया।
• अगर आपका स्टोर विलंबित कैप्चर (delayed capture) का उपयोग करता है, तो प्री-ऑर्डर या फ़ुलफ़िलमेंट पर कैप्चर करने (capture-at-fulfillment) का व्यवहार।
• एक से ज़्यादा पेमेंट मेथड वाले ऑर्डर के लिए रिटर्न ऐप हैंडलिंग।

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

अगर आपको इनमें से किसी भी स्थिति में मदद चाहिए, तो Shopify समर्थन से संपर्क करें:

• रोलआउट में मौजूद बाज़ार के लिए Shop Cash की उपलब्धता की समीक्षा करना।
• किसी विफल (failed) Shop Cash कैप्चर या रिफ़ंड की जांच करना।
• आपके सामान्य पेआउट तालमेल (cadence) और एक अतिरिक्त पेआउट साइकल के बाद किसी गुम (missing) Shop Cash पेआउट लेन-देन की जांच करना।
• इसकी समीक्षा करना कि क्या अमान्य की गई या एक्सपायर हो चुकी Shop Cash ऑथराइज़ेशन को फिर से ऑथराइज़ किया जा सकता है।
• जटिल ERP, OMS, प्री-ऑर्डर, या फ़ुलफ़िलमेंट वर्कफ़्लो के लिए लॉन्च की योजना बनाना।

Shop Cash ऑर्डर वॉल्यूम बढ़ाने से पहले, निम्नलिखित जांच पूरी करें:

• shop_cash के लिए ERP और OMS पेमेंट-मेथड मैपिंग को डिप्लॉय किया गया है और वेरिफ़ाई किया गया है।
• ऑथराइज़ेशन और कैप्चर लेन-देन सहित, एक सैंपल Shop Cash ऑर्डर शुरू से अंत तक इंजस्ट (ingest) किया गया है।
• एक सैंपल Shop Cash पेआउट क्रेडिट का मिलान स्रोत (सोर्स) ऑर्डर या कई ऑर्डर से किया गया है।
• एक सैंपल Shop Cash रिफ़ंड प्रोसेस किया गया है और रिफ़ंड डेबिट के साथ उसका मिलान किया गया है।
• ग्रुप की गई Shop Cash पेआउट पंक्तियां समर्थित (supported) हैं या उनमें मैन्युअल रूप से मिलान की प्रक्रिया शामिल है।
• आपकी सहायता (support) और फ़ाइनेंस टीमों द्वारा आंशिक रिफ़ंड आवंटन (allocation) को समझा गया है।
• लागू होने पर प्री-ऑर्डर, मैन्युअल कैप्चर और फ़ुलफ़िलमेंट पर कैप्चर करने के व्यवहार को मान्य (validate) किया गया है।
• रिटर्न ऐप सही Shop Cash कैप्चर लेन-देन की पहचान कर सकते हैं और उसे रिफ़ंड कर सकते हैं।
• सहायता और फ़ाइनेंस टीमों को ग्राहक के Shop Cash बैलेंस, Shop ऑफ़र और Shop Campaign की बिलिंग एक्टिविटी के बीच का अंतर पता है।

API और ऑर्डर डेटा की ज़रूरतों के लिए, Shop Cash ऑर्डर डेटा और थर्ड-पार्टी इंटीग्रेशन देखें। पेआउट की ज़रूरतों के लिए, Shop Cash पेआउट का मिलान करना देखें।