Documentation Index
Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt
Use this file to discover all available pages before exploring further.
अवलोकन
डिजिटल प्रोडक्ट डिलीवरी डिजिटल फ़ाइलें अधिकारिता प्रकार है। आप अपने फाइल्स को एक बार डिजिटल फ़ाइलें अधिकारिता में अपलोड करते हैं, उत्पाद से अधिकारिता जोड़ते हैं और Dodo Payments प्रत्येक भुगतान ग्राहक को ईमेल और ग्राहक पोर्टल के माध्यम से प्रीसाइन्ड डाउनलोड लिंक देता है। अधिकारिता समर्थन करता है:- होस्टेड फाइल अपलोड्स: फाइलों को Dodo Payments पर स्टोर करें और उन्हें शॉर्ट-लिव्ड प्रीसाइन्ड URLs के माध्यम से सेवा दें।
- बाहरी डाउनलोड लिंक: Dropbox, Google Drive, S3, या किसी भी URL पर होस्टेड फाइलों से लिंक करें।
- डाउनलोड निर्देश: ग्राहक को उनके ऑर्डर पेज पर और डिलीवरी ईमेल में दिखाया जाने वाला फ्री-फॉर्म टेक्स्ट।
प्रमुख विशेषताएं
अपलोड फाइल्स (PDF, ZIP, इमेज, वीडियो, आदि) 100 MB तक। फाइल्स को स्ट्रीम और प्रभावी ढंग से संग्रहीत किया जाता है। एक ही अधिकारिता में जितनी फाइल्स की जरूरत हो उतनी अटैच करें। बाहरी डाउनलोड लिंक (Dropbox, Google Drive, साइन किए गए S3 URLs) को वैकल्पिक या अतिरिक्त के रूप में प्रदान करें। होस्टेड फाइलें शॉर्ट-लिव्ड प्रीसाइन्ड URLs के माध्यम से सेवा की जाती हैं। प्रत्येक डाउनलोड URL लगभग 15 मिनट के बाद स्वचालित रूप से समाप्त हो जाता है।डिजिटल प्रोडक्ट डिलीवरी सेट करें
अपने Dodo Payments डैशबोर्ड में Entitlements पर जाएं और एक नया अधिकारिता बनाने के लिए + पर क्लिक करें। Digital Product Delivery को इंटीग्रेशन के रूप में चुनें। किसी भी संयोजन को कॉन्फ़िगर करें:- फ़ाइलें: एक या एक से अधिक फ़ाइलें अपलोड करें। प्रत्येक अपलोड एक
file_idरिटर्न करता है जो अधिकारिता में जोड़ा गया है। - बाहरी URL: होस्टेड फ़ाइलों के साथ दिया गया सार्वजनिक रूप से पहुंच योग्य HTTPS लिंक।
- निर्देश: ग्राहक को दिखाया गया फ्री-फॉर्म टेक्स्ट (जैसे, “Unzip और setup.sh चलाएं”)।
उत्पादों से जोड़ें
एक उत्पाद खोलें, Advanced Settings → Entitlements & Credits बढ़ाएं, और अपनी डिजिटल फ़ाइलें अधिकारिता चुनें। अधिकारिता प्रत्येक सफल खरीद या सक्रिय सदस्यता पर दी जाती है जो उस उत्पाद से जुड़ी होती है।
डिलीवरी कैसे काम करती है
डिजिटल फ़ाइलें डिलीवरी मानक अनुदान जीवनचक्र का पालन करती है:| इवेंट | व्यवहार |
|---|---|
payment.succeeded (एक बार) | एक अनुदान जारी करें। अनुदान लगभग 15 मिनट के लिए मान्य प्रीसाइन्ड डाउनलोड URLs ले जाता है; ग्राहक उन्हें फिर से खोलकर ईमेल लिंक या ग्राहक पोर्टल पेज पर ला सकते हैं। |
subscription.active | एक अनुदान जारी करें। फ़ाइलें सक्रिय होने के दौरान एक्सेसिबल रहती हैं। |
subscription.renewed | नो-ऑप। वही अनुदान जारी रहता है; प्रत्येक फेच पर नए प्रीसाइन्ड URLs मिंट किए जाते हैं। |
subscription.on_hold / cancelled / expired | अनुदान रद्द करें। नए प्रीसाइन्ड URLs अब नहीं जारी किए जाते। |
subscription.plan_changed | पुराने अनुदान को रद्द करें; नए प्लान की अधिकारिता के लिए एक नया जारी करें। |
refund.succeeded (एक बार) | अनुदान रद्द करें। |
| मैनुअल रद्द करें | revocation_reason: manual के साथ रद्द करें। |
ग्राहक अनुभव
खरीद पुष्टि
सफल लेन-देन के बाद, ग्राहक को डाउनलोड लिंक और आपके द्वारा कॉन्फ़िगर किए गए किसी भी निर्देश के साथ ईमेल प्राप्त होता है।
ग्राहक पोर्टल एक्सेस
ग्राहक ग्राहक पोर्टल से कभी भी डाउनलोड लिंक फिर से प्राप्त कर सकते हैं। पोर्टल पेज मांग पर ताज़ा प्रीसाइन्ड URLs उत्पन्न करता है, इसलिए वही खरीद काम करना जारी रखती है, भले ही ईमेल के लिंक समाप्त हो गए हों।
प्रोग्रामेटिक रूप से फ़ाइलों का प्रबंधन करें
एक अधिकारिता पर फ़ाइल अपलोड करें
अनुदानों की सूची और डाउनलोड URLs को हल करें
एक अधिकारिता से फ़ाइल को हटाएं
महत्वपूर्ण विचार
- प्रीसाइन्ड URLs जल्दी समाप्त हो जाते हैं। अनुदान पेआलोड्स या वेबहुक ईवेंट्स में लौटाए गए डाउनलोड URLs लगभग 15 मिनट के लिए मान्य होते हैं। उन्हें स्टोर न करें; जब ग्राहक को फिर से डाउनलोड की आवश्यकता होती है, तब उन्हें पुनः प्राप्त करें।
- अपडेटिंग फाइल्स केवल भविष्य की खरीदों को प्रभावित करता है। कोई फ़ाइल बदलने या हटाने से पहले से जारी डाउनलोड को पिछे मोड़कर नहीं बदला जाता है। पिछले ग्राहक अपने अनुदान के निर्माण के समय के संस्करण को फिर से ला सकते हैं।
- रिफंड्स डाउनलोड की गई प्रतियों को अमान्य नहीं करते हैं। एक ग्राहक जिसने पहले से ही एक फ़ाइल डाउनलोड की है, वह प्रतिलिपि रखती है। पुनः प्रकाशित सामग्री के लिए (लाइसेंस-प्रतिबंधित मीडिया, समय-सीमित एक्सेस), डिजिटल फ़ाइलों को लाइसेंस कीज़ के साथ जोड़कर और रनटाइम पर सत्यापित करें।
- संवेदनशील सामग्री के लिए, उनकी अपनी प्राधिकरण के साथ बाहरी URLs को प्राथमिकता दें। Dodo Payments के प्रीसाइन्ड URLs छोटी अवधि के होते हैं लेकिन उनकी खिड़की में बिना प्रमाणित किये जाते हैं; जो कोई भी URL के साथ होता है वह उस विंडो में डाउनलोड कर सकता है। बाहरी रूप से होस्ट की गई, खाता-गेटेड सामग्री मजबूत गारंटी प्रदान करती है।
API प्रबंधन
वैकल्पिक बाहरी URL और निर्देशों के साथ एक डिजिटल फ़ाइलें अधिकारिता बनाएं। अपलोड करें एक फ़ाइल (100 MB तक) और इसे अधिकारिता में जोडें। एक अधिकारिता से फ़ाइल को हटाएं। अनुदानों की सूची और हल किए गए डाउनलोड URLs को पढ़ें। निर्देशों, बाहरी URL को अपडेट करें या फ़ाइलों को बदलें। हाथ से ग्राहक की एक्सेस को रद्द करें।वेबहुक्स
डिजिटल फ़ाइल डिलीवरी और रद्द करने वाले चारentitlement_grant.* वेबहुक ईवेंट्स का उपयोग करते हैं। डिजिटल फ़ाइलों के अनुदानों के लिए, पेआलोड में एक digital_product_delivery ऑब्जेक्ट शामिल होता है जिसमें हल की गई फ़ाइल सूची (प्रीसाइन्ड URLs, फ़ाइलनाम, आकार), वैकल्पिक instructions और वैकल्पिक external_url शामिल होते हैं।
पुरानी डिजिटल प्रोडक्ट डिलीवरी
उत्पादों को पुरानेdigital_product_delivery ब्लॉक के साथ खुद उत्पाद पर कॉन्फ़िगर किया गया है, उन्हें स्वचालित रूप से एक डिजिटल फ़ाइलें अधिकारिता में माइग्रेट किया गया है। विरासती उत्पाद फ़ाइल API के तहत अपलोड की गई मौजूदा फाइलें संरक्षित की जाती हैं; उन्हें डाउनलोड किया जा सकता है और अनुदान पेआलोड्स में source: "legacy" के साथ टैग की जा सकती है। भविष्य के अपडेट (फाइलें जोड़ना, निर्देश बदलना, बाहरी URL बदलना) को Entitlements के तहत माइग्रेट डिजीटल फ़ाइलें अधिकारिता को एडिट करके किया जाना चाहिए।
विरासती उत्पाद स्तर के फ़ील्ड (digital_product_delivery.external_url, digital_product_delivery.instructions) पिछड़े संगतता के लिए उत्पाद प्रतिक्रियाओं पर भरी जाती रहती हैं, लेकिन आगे चलकर अधिकारिता सत्य का स्रोत होता है।
सर्वोत्तम प्रथाएँ
- डाउनलोड को एक बार का मानें। ग्राहक लिंक साझा करेंगे या खो देंगे, इसलिए अपने उत्पाद को इस धारणा के आसपास डिज़ाइन करें कि जो कुछ भी वे डाउनलोड करते हैं वह उनके पास रखने के लिए है।
- निर्देशों का उपयोग करके अपेक्षाएं सेट करें। मल्टी-फ़ाइल बंडल्स के लिए, एक
instructionsलाइन जोड़ें जो बताती है कि पहले क्या इंस्टॉल करना है या फाइलों को कैसे मिलाना है। - 100 MB की सीमा का ध्यान रखें। बड़े आर्टिफैक्ट्स (मल्टी-GB डेटा सेट्स, वीडियो कोर्सेस) को बाहरी रूप से होस्ट किया जाना चाहिए और उसके बजाय
external_urlके माध्यम से लिंक किया जाना चाहिए। - परिवर्तनीय एक्सेस के लिए लाइसेंस कीज़ के साथ मिलाएं। यदि आपको किसी उत्पाद की विशेषताओं की पहुंच को रिफंड के बाद वापस लेना है, तो डिजिटल फ़ाइलों की अधिकारियों को एक लाइसेंस की प्रविष्टी के साथ जोड़ें और रनटाइम पर कुंजी सत्यापित करें।
- ग्राहक-पोर्टल रिफ्रेश फ्लो का परीक्षण करें। पुष्टि करें कि एक ग्राहक एक सप्ताह बाद पोर्टल पर वापस जा सकता है और फिर भी एक कामकाजी डाउनलोड लिंक प्राप्त कर सकता है। यह प्राथमिक पुनर्प्राप्ति पथ है जब ईमेल लिंक समाप्त हो जाते हैं।