Shop Cash ऑर्डर डेटा और थर्ड-पार्टी इंटिग्रेशन

जब कोई ग्राहक किसी ऑर्डर पर Shop Cash का उपयोग करता है, तो Shop Cash को पेमेंट मेथड माना जाता है। यह कोई छूट, गिफ़्ट कार्ड या स्टोर क्रेडिट नहीं है। ऑर्डर का कोई भी शेष बैलेंस Shop Pay या Shop Pay Installments से चुकाया जाता है।

उदाहरण के लिए, यदि कोई ग्राहक $100 USD के ऑर्डर पर $25 USD के Shop Cash का उपयोग करता है, तो उस ऑर्डर में $25 USD का Shop Cash पेमेंट और $75 USD का Shop Pay पेमेंट शामिल होता है। आपके ऑर्डर डेटा में एक ही ऑर्डर के लिए एक से ज़्यादा पेमेंट मेथड शामिल हो सकते हैं।

जहां गेटवे वैल्यू उपलब्ध हैं, वहां Shop Cash shop_cash गेटवे वैल्यू के साथ ऑर्डर लेन-देन के रूप में दिखाई देता है। Shop Cash लेन-देन एक मानक लेन-देन लाइफ़साइकल का पालन करता है, जैसे कि ऑथराइज़ेशन, कैप्चर, अमान्य करना और रिफ़ंड। Shop Cash कंबाइंड सेल लेन-देन प्रकार का उपयोग नहीं करता है।

यदि ग्राहक किसी Shop Campaign के Shop ऑफ़र का भी उपयोग करता है, तो कैम्पेन-फ़ंडेड वैल्यू को उसी shop_cash ऑर्डर लेन-देन राशि में शामिल किया जाता है। खरीदार-बैलेंस और कैम्पेन-फ़ंडेड हिस्सों को अलग-अलग ऑर्डर लेन-देन के रूप में नहीं दर्शाया जाता है। जनवरी 2026 से, कैम्पेन की लागतें आपके भुगतान से काटे जाने के बजाय आपके Shopify बिल में जोड़ी जाती हैं, इसलिए भुगतान एक्टिविटी में कैम्पेन बिलिंग लेन-देन केवल उन कैम्पेन पर लागू होते हैं जो उस तारीख से पहले चलाए गए थे। अधिक जानकारी के लिए, शुल्क, Shop Campaigns और Shop Cash देखें।

ऑर्डर, लेन-देन, पेमेंट, फ़ुलफ़िलमेंट, रिफ़ंड या रिटर्न इम्पोर्ट करने वाले थर्ड-पार्टी सिस्टम को Shop Cash को पेमेंट मेथड के रूप में पहचानने की आवश्यकता होती है। यदि कोई सिस्टम Shop Cash को नहीं पहचानता है, तो ऐसे ऑर्डर जिनमें Shop Cash शामिल है, वे इम्पोर्ट होने में विफल हो सकते हैं, अधूरे पेमेंट डेटा के साथ इम्पोर्ट हो सकते हैं या उनके लिए मैन्युअल मैपिंग की आवश्यकता हो सकती है।

अपने थर्ड-पार्टी सिस्टम प्रोवाइडर के साथ निम्नलिखित आवश्यकताओं का रिव्यू करें:

• सिस्टम एक ऑर्डर पर एक से ज़्यादा पेमेंट मेथड को सपोर्ट कर सकता है।
• सिस्टम shop_cash को पेमेंट मेथड के रूप में मैप कर सकता है।
• सिस्टम Shop Cash को छूट, गिफ़्ट कार्ड या स्टोर क्रेडिट नहीं मानता है।
• सिस्टम हर Shop Cash ऑथराइज़ेशन, कैप्चर, अमान्य करने की प्रक्रिया और रिफ़ंड के लिए ऑर्डर लेन-देन आईडी (ID) स्टोर करता है।
• सिस्टम Shop Cash की पूरी ऑथराइज़ेशन वैल्यू को काटे बिना स्टोर करता है, बशर्ते यह वैल्यू सिस्टम द्वारा इम्पोर्ट किए जाने वाले डेटा में शामिल हो।
• सिस्टम ऑथराइज़ेशन वैल्यू को अपारदर्शी स्ट्रिंग मानता है और उन्हें पार्स, डिकोड, नॉर्मलाइज़, हैश या उनका कोई अर्थ नहीं निकालता है।
• सिस्टम ऐसे रिफ़ंड प्रोसेस कर सकता है, जो Shop Pay और Shop Cash दोनों में फ़ंड वापस करते हैं।
• सिस्टम कार्ड पेमेंट लेन-देन से अलग Shop Cash भुगतान लेन-देन का लेखा मिलान कर सकता है।
• सिस्टम यह नहीं मानता कि लेन-देन किसी विशिष्ट क्रम में वापस किए जाते हैं।

यदि आपका थर्ड-पार्टी सिस्टम यह मानता है कि हर ऑर्डर में केवल एक ही पेमेंट मेथड होता है, तो उस सिस्टम के ज़रिए Shop Cash ऑर्डर प्रोसेस करने से पहले प्रोवाइडर से संपर्क करें।

Shop Cash लेन-देन पर ऑथराइज़ेशन वैल्यू एक अपारदर्शी, वेरिएबल-लेंथ वाली स्ट्रिंग होती है। यह कोई छोटा कार्ड ऑथराइज़ेशन कोड नहीं है और इसे इंसानों द्वारा पढ़ा नहीं जा सकता।

यदि आपका ERP, OMS, या कोई अन्य थर्ड-पार्टी सिस्टम Shop Cash ऑथराइज़ेशन वैल्यू इम्पोर्ट करता है, तो पूरी वैल्यू को बिल्कुल वैसे ही स्टोर करें जैसे वह दी गई है। जहां संभव हो, वेरिएबल-लेंथ या अनबाउंडेड टेक्स्ट फ़ील्ड का उपयोग करें।

जब आपका सिस्टम Shop Cash ऑथराइज़ेशन वैल्यू स्टोर करता है, तो इन दिशानिर्देशों का पालन करें:

• वैल्यू को किसी छोटी और तय लंबाई में न काटें, जैसे 50 या 100 कैरेक्टर।
• वैल्यू के किसी भी हिस्से को पार्स न करें या उससे कोई अर्थ न निकालें।
• कैप्चर, अमान्य करने की प्रक्रिया, या रिफ़ंड API ऑपरेशन के लिए लेन-देन की पहचान करने हेतु ऑथराइज़ेशन वैल्यू का उपयोग न करें।

काटी गई ऑथराइज़ेशन वैल्यू के कारण थर्ड-पार्टी इम्पोर्ट या डाउनस्ट्रीम ERP और OMS की प्रोसेसिंग विफल हो सकती है।

Admin API के ज़रिए कैप्चर, अमान्य करने की प्रक्रिया, और रिफ़ंड का सपोर्ट करने के लिए, ऑर्डर लेन-देन आईडी (ID) और पैरेंट लेन-देन रिलेशनशिप को स्टोर करें। Admin API में कैप्चर और अमान्य करने के ऑपरेशन parentTransactionId के साथ ऑथराइज़ेशन लेन-देन की पहचान करते हैं। रिफ़ंड ऑपरेशन parentId के साथ रिफ़ंड के योग्य कैप्चर लेन-देन की पहचान करते हैं।

जब कोई ऐप या इंटिग्रेशन API के ज़रिए Shop Cash रिफ़ंड जारी करता है, तो रिफ़ंड का पैरेंट Shop Cash कैप्चर लेन-देन होना चाहिए, न कि Shop Cash ऑथराइज़ेशन लेन-देन। ऑथराइज़ेशन लेन-देन के ख़िलाफ़ होने वाले रिफ़ंड अस्वीकार कर दिए जाते हैं।

रिफ़ंड ऐप और वेबहुक हैंडलर को रिफ़ंड के योग्य Shop Cash कैप्चर लेन-देन की पहचान करनी चाहिए, उस कैप्चर के लिए शेष रिफ़ंड के योग्य राशि की गणना करनी चाहिए और कैप्चर लेन-देन आईडी (ID) के आधार पर रिफ़ंड बनाना चाहिए।

जब आप Admin API, ऑर्डर एक्सपोर्ट, भुगतान एक्सपोर्ट, या थर्ड-पार्टी ऐप एक्सपोर्ट का इस्तेमाल करते हैं, तो Shop Cash को पेमेंट डेटा के तौर पर समझें। आपके द्वारा उपयोग किए जाने वाले एक्सपोर्ट या API संसाधन के आधार पर, Shop Cash की जानकारी को पेमेंट मेथड, गेटवे, ऑर्डर के लेन-देन, भुगतान के लेन-देन और रिफ़ंड डेटा के ज़रिए दिखाया जा सकता है।

जब आप कोई इंटीग्रेशन बनाते हैं या अपडेट करते हैं, तो Shop Cash वाले ऑर्डर के लिए नीचे दी गई जानकारी को स्टोर करें:

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

उपलब्ध Admin API फ़ील्ड की जानकारी के लिए, Admin API ऑर्डर लेन-देन डेवलपर दस्तावेज़ीकरण देखें। नए इंटीग्रेशन के लिए, अप्रचलित हो चुके फ़ील्ड, जैसे OrderTransaction.authorizationCode पर निर्भर होने से बचें।

नीचे दिया गया आसान उदाहरण $100 USD के ऑर्डर को दिखाता है, जिसका भुगतान Shopify Payments के ज़रिए $75 USD और Shop Cash के ज़रिए $25 USD देकर किया गया है। ये वैल्यू सिर्फ़ समझाने के लिए हैं।

{
  "transactions": [
    {
      "kind": "authorization",
      "gateway": "shopify_payments",
      "status": "success",
      "amount": "75.00",
      "currency": "USD",
      "parent_id": null,
      "authorization": "ch_3OabcXYZ..."
    },
    {
      "kind": "authorization",
      "gateway": "shop_cash",
      "status": "success",
      "amount": "25.00",
      "currency": "USD",
      "parent_id": null,
      "authorization": "<long-opaque-variable-length-string>"
    },
    {
      "kind": "capture",
      "gateway": "shop_cash",
      "status": "success",
      "amount": "25.00",
      "currency": "USD",
      "parent_id": "<shop-cash-authorization-transaction-id>",
      "authorization": null
    }
  ]
}

Shop Cash अन्य पेमेंट या प्रमोशनल वैल्यू जैसा दिख सकता है, लेकिन आपके सिस्टम को हर वैल्यू को अलग तरह से ट्रीट करना चाहिए:

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

• Shop Cash को पेमेंट मेथड के रूप में मैप किया गया है।
• Shop Cash और Shop Pay वाले ऑर्डर को दोनों पेमेंट मेथड के साथ इंपोर्ट किया जाता है।
• पेमेंट मेथड का लॉजिक यह मानकर नहीं चलता कि हर ऑर्डर के लिए एक ही पेमेंट मेथड है।
• ऑथराइज़ेशन वैल्यू लंबी अपारदर्शी स्ट्रिंग के रूप में स्टोर की जाती हैं और उन्हें छोटा नहीं किया जाता है।
• रिफ़ंड लॉजिक सही कैप्चर लेन-देन को रिफ़ंड कर सकता है।
• रिफ़ंड लॉजिक, फ़ंड को सही पेमेंट मेथड पर वापस कर सकता है।
• भुगतान लेखा मिलान प्रक्रिया में Shop Cash क्रेडिट, रिफ़ंड और कैम्पेन लेन-देन के प्रकारों को शामिल किया जा सकता है।
• फ़ुलफ़िलमेंट, अकाउंटिंग और रिटर्न के वर्कफ़्लो, Shop Cash को छूट के रूप में ट्रीट नहीं करते हैं।

अगर आप एक से ज़्यादा सिस्टम का उपयोग करते हैं, तो उस हर सिस्टम के लिए यह समीक्षा पूरी करें जो ऑर्डर, लेन-देन, भुगतान, फ़ुलफ़िलमेंट, रिफ़ंड, या रिटर्न का डेटा प्राप्त करता है।