डिजिटल कोड डिलीवरी ऑटोमेट कैसे करें

संक्षिप्त उत्तर

डिजिटल कोड डिलीवरी ऑटोमेट करने का मतलब है मैन्युअल ऑर्डर प्रोसेसिंग को एक पाइपलाइन से रिप्लेस करना: कस्टमर पेमेंट आपके सप्लायर को API कॉल ट्रिगर करता है, सप्लायर कोड रिटर्न करता है, और आपका सिस्टम सेकंडों में कस्टमर को डिलीवर करता है। छह कंपोनेंट हैं: पेमेंट इवेंट लिसनर, सप्लायर API ऑर्डर कॉल, रिस्पॉन्स से कोड पार्सिंग, कस्टमर डिलीवरी (ईमेल/पेज/मैसेज), async अपडेट के लिए वेबहुक लिसनर, और फेल्ड ऑर्डर के लिए एरर हैंडलिंग। एक काम करती ऑटोमेशन बिना किसी मैन्युअल स्टेप के असीमित ऑर्डर प्रोसेस करती है।

परिभाषा: ऑटोमेटेड डिजिटल कोड डिलीवरी एक फुलफिलमेंट पाइपलाइन है जो बिना मानवीय हस्तक्षेप के कस्टमर पेमेंट को कोड डिलीवरी से कनेक्ट करती है — API ऑर्डर क्रिएशन, वेबहुक इवेंट और प्रोग्रामेटिक कोड डिस्ट्रीब्यूशन उपयोग करके।

मुख्य निष्कर्ष: मैन्युअल कोड डिलीवरी स्केल पर फेल होती है: यह देरी, मानवीय एरर और सपोर्ट ओवरहेड लाती है। ऑटोमेशन तीनों हटा देती है। एक डेवलपर एक सिस्टम बना सकता है जो दस ऑर्डर जितनी मेहनत से हजारों डेली ऑर्डर हैंडल करे।

यह गाइड किसके लिए है

• डेवलपर्स जो डिजिटल गुड्स स्टोर बना रहे हैं और डिलीवरी पाइपलाइन इम्प्लीमेंट करनी है
• स्टोर ऑपरेटर जो मैन्युअली कोड डिलीवर कर रहे हैं और ऑटोमेट करना चाहते हैं
• Telegram बॉट डेवलपर जो ऑटोमेटेड टॉप-अप और गिफ्ट कार्ड डिलीवरी चाहते हैं

मैन्युअल डिलीवरी स्केल पर क्यों फेल होती है

20 ऑर्डर/दिन पर मैन्युअल काम करता है। 200 पर बॉटलनेक बनता है। 2,000 पर टूट जाता है।

ऑटोमेटेड डिलीवरी पाइपलाइन

[कस्टमर पेमेंट करता है]
      │
      ▼
[पेमेंट गेटवे वेबहुक/कॉलबैक फायर]
      │
      ▼
[ऑर्डर हैंडलर: पेमेंट वैलिडेट करें, ऑर्डर रिक्वेस्ट बनाएं]
      │
      ▼
[सप्लायर API को POST /orders]
      │
      ├─[सफलता]──▶ [रिस्पॉन्स से कोड पार्स करें]
      │                      │
      │                      ▼
      │              [कस्टमर को कोड डिलीवर करें]
      │              (ईमेल / ऑर्डर पेज / बॉट मैसेज)
      │
      └─[एरर]───▶ [लॉग एरर, ops को अलर्ट, जरूरत हो तो रिफंड]

कंपोनेंट 1: पेमेंट इवेंट लिसनर

आपकी फुलफिलमेंट पाइपलाइन तब शुरू होती है जब पेमेंट कन्फर्म होती है — जब इनिशिएट होती है तब नहीं।

नियम:

• केवल कन्फर्म्ड पेमेंट इवेंट पर फुलफिलमेंट ट्रिगर करें (ऑर्डर क्रिएशन पर नहीं)
• Idempotency हैंडल करें: अगर एक ही पेमेंट इवेंट दो बार फायर हो तो दो ऑर्डर न बनाएं
• वैलिडेट करें कि पेमेंट अमाउंट एक्सपेक्टेड प्रोडक्ट कॉस्ट से मैच करता है

अधिकांश पेमेंट गेटवे (Stripe, PayPal, आदि) पेमेंट कन्फर्म होने पर वेबहुक इवेंट भेजते हैं। सही इवेंट टाइप सब्सक्राइब करें:

• Stripe: payment_intent.succeeded
• PayPal: PAYMENT.CAPTURE.COMPLETED

क्लाइंट साइड (ब्राउज़र) से सप्लायर API कॉल कभी ट्रिगर न करें। हमेशा अपने सर्वर से।

कंपोनेंट 2: सप्लायर API ऑर्डर कॉल

पेमेंट कन्फर्म होने के बाद, सप्लायर का ऑर्डर क्रिएशन एंडपॉइंट कॉल करें:

POST /orders
Content-Type: application/json
Authorization: Bearer {api_key}

{
  "sku": "steam-20-usd",
  "quantity": 1,
  "reference": "ORD-{your_order_id}"
}

reference के रूप में अपना इंटर्नल ऑर्डर ID उपयोग करें। इससे सप्लायर ऑर्डर को अपने डेटाबेस से रिकन्सिल करना आसान होता है। इसे हर ऑर्डर के लिए यूनिक बनाएं।

रिस्पॉन्स पर क्या करें:

कंपोनेंट 3: कोड पार्सिंग

API रिस्पॉन्स आमतौर पर स्ट्रक्चर्ड फॉर्मेट में कोड रखता है। डिलीवर करने से पहले पार्स और वैलिडेट करें:

{
  "order_id": "SUP-99887",
  "status": "completed",
  "items": [
    {
      "code": "XXXXX-YYYYY-ZZZZZ",
      "pin": null,
      "instructions": "Redeem at store.steampowered.com"
    }
  ]
}

वैलिडेट करें:

• status completed है (pending या failed नहीं)
• code फील्ड null या empty नहीं है
• अगर प्रोडक्ट PIN चाहता है, pin फील्ड null नहीं है

टॉप-अप प्रोडक्ट के लिए, रिस्पॉन्स में कोड की बजाय डिलीवरी कन्फर्मेशन हो सकती है।

कंपोनेंट 4: कस्टमर डिलीवरी

कोड उस चैनल से डिलीवर करें जो आपके कस्टमर उपयोग करते हैं:

कोड के साथ हमेशा शामिल करें:

• कोड खुद (कॉपी-फ्रेंडली फॉर्मेट)
• प्रोडक्ट नाम और डिनॉमिनेशन
• एक्टिवेशन इंस्ट्रक्शन या लिंक
• आपका सपोर्ट कॉन्टेक्ट

कंपोनेंट 5: Async ऑर्डर के लिए वेबहुक लिसनर

जो ऑर्डर तुरंत फुलफिल नहीं हुए (स्टेटस pending), उनके लिए फुलफिलमेंट पूरा होने पर अपडेट पाने के लिए वेबहुक उपयोग करें:

वेबहुक हैंडलर आवश्यकताएं:

1. सप्लायर IP/डोमेन से POST रिक्वेस्ट एक्सेप्ट करें
2. वेबहुक सिग्नेचर वेरिफाई करें (HMAC या समान)
3. 5 सेकंड के भीतर HTTP 200 रिटर्न करें
4. Async प्रोसेसिंग के लिए इवेंट क्यू करें
5. प्रोसेस: अगर status = completed → कस्टमर को कोड डिलीवर करें

न करें:

• सिंक्रोनस वेबहुक हैंडलर के अंदर बिज़नेस लॉजिक प्रोसेस
• Non-200 रिटर्न जब तक आप सप्लायर को रिट्राई नहीं करवाना चाहते
• मान लें कि वेबहुक ऑर्डर, ऑर्डर क्रिएशन ऑर्डर से मेल खाता है

कंपोनेंट 6: एरर हैंडलिंग

एरर पाथ को हैप्पी पाथ जितना ही डिज़ाइन चाहिए।

मॉनिटरिंग और अलर्टिंग

मॉनिटरिंग सेट अप करें:

इंटीग्रेशन चेकलिस्ट

• पेमेंट कन्फर्मेशन वेबहुक हैंडलर इम्प्लीमेंट और टेस्ट किया
• Idempotency लॉजिक: डुप्लीकेट इवेंट डुप्लीकेट ऑर्डर नहीं बनाते
• ऑथ हेडर के साथ सप्लायर API ऑर्डर कॉल इम्प्लीमेंट
• सभी रिस्पॉन्स स्टेटस हैंडल: completed, pending, failed
• कोड पार्सिंग वैलिडेट करती है कि code फील्ड non-empty है
• आपके प्राइमरी चैनल के लिए कस्टमर डिलीवरी इम्प्लीमेंट
• डिलीवरी में कोड + प्रोडक्ट नाम + एक्टिवेशन इंस्ट्रक्शन + सपोर्ट कॉन्टेक्ट
• सिग्नेचर वैलिडेशन के साथ वेबहुक लिसनर
• वेबहुक इवेंट async प्रोसेस किए जाते हैं
• Pending ऑर्डर के लिए पोलिंग फॉलबैक (अगर वेबहुक उपलब्ध नहीं)
• अलर्टिंग के साथ एरर लॉगिंग
• लो-बैलेंस अलर्ट के साथ बैलेंस मॉनिटरिंग
• एक्सपेक्टेड पीक वॉल्यूम पर लोड टेस्ट

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

कोड डिलीवरी ऑटोमेट करने के लिए मिनिमम टेक स्टैक क्या चाहिए? सर्वर-साइड रनटाइम (Node.js, Python, PHP, Go), HTTP क्लाइंट लाइब्रेरी, ऑर्डर और डिलीवरी स्टेट स्टोर करने के लिए डेटाबेस, और वेबहुक सपोर्ट वाला पेमेंट गेटवे। कोई स्पेशलाइज्ड फ्रेमवर्क नहीं चाहिए।

मैन्युअल की तुलना में ऑटोमेटेड डिलीवरी कितनी तेज़ है? ऑटोमेटेड डिलीवरी पेमेंट कन्फर्मेशन के सेकंडों में होती है। मैन्युअल में मिनट से घंटे लग सकते हैं। कस्टमर के लिए डिजिटल प्रोडक्ट के लिए कुछ मिनट से ज़्यादा इंतजार सिस्टम एरर जैसा लगता है।

अगर ऑर्डर के दौरान सप्लायर API डाउन हो तो क्या होता है? रिट्राई लॉजिक इम्प्लीमेंट करें (एक्सपोनेंशियल बैकऑफ के साथ 2-3 रिट्राई)। अगर सब फेल हों, ऑर्डर मैन्युअल रिव्यू के लिए फ्लैग करें, ऑपरेशंस टीम को नोटिफाई करें और सप्लायर से संपर्क करें। फेल्ड ऑर्डर के लिए कस्टमर को चार्ज न करें।

उस कस्टमर को कैसे हैंडल करें जो कहता है कि उसे कोड नहीं मिला? अपने डिलीवरी लॉग चेक करें (आपको टाइमस्टैम्प, ऑर्डर ID और कस्टमर आइडेंटिफायर के साथ हर कोड डिलीवरी लॉग करनी चाहिए)। अगर आपके सिस्टम ने डिलीवरी कन्फर्म की है, कस्टमर को कोड दिखाएं। अगर डिलीवरी फेल हुई, अपने लॉग से नई डिलीवरी जारी करें।

क्या वेबहुक चाहिए या ऑर्डर स्टेटस पोल कर सकते हैं? पोलिंग काम करती है लेकिन स्केल पर अनएफिशिएंट है। 100 ऑर्डर/दिन पर पोलिंग ठीक है। 1,000+ पर, रेट लिमिट समस्याओं और डिलीवरी देरी से बचने के लिए वेबहुक ज़रूरी हैं।

क्या Telegram बॉट पर ऑटोमेटेड डिलीवरी चला सकते हैं? हाँ। डिलीवरी पाइपलाइन वही है — फर्क केवल यह है कि कोड ईमेल की बजाय bot.sendMessage() से भेजा जाता है। सप्लायर API कॉल और एरर हैंडलिंग एक जैसी है।

FoxReload API से ऑटोमेटेड डिलीवरी बनाएं

FoxReload के API में ऑर्डर क्रिएशन, ऑर्डर स्टेटस, वेबहुक और रिकन्सिलिएशन शामिल हैं — पूरी तरह ऑटोमेटेड डिजिटल गुड्स डिलीवरी पाइपलाइन के लिए सब कुछ।

API एक्सेस पाएं | API डॉक्युमेंटेशन | कैटलॉग ब्राउज़ करें

संबंधित गाइड:

• ऑनलाइन स्टोर के लिए गिफ्ट कार्ड API
• डिजिटल गुड्स ऑर्डर के लिए वेबहुक
• रिसेलर्स के लिए गेम टॉप-अप API
• बिना इन्वेंटरी के डिजिटल गुड्स कैसे बेचें