Digital Product Delivery

​

अवलोकन

• Hosted file uploads: फ़ाइलों को Dodo Payments पर store करें और short-lived presigned URLs के ज़रिए serve करें।
• External download links: Dropbox, Google Drive, S3 या किसी भी URL पर hosted फ़ाइलों से link करें।
• Download instructions: customer को उनके order page और delivery email में दिखने वाला free-form text।

​

मुख्य सुविधाएँ

​

Digital Product Delivery सेट अप करें

1

Open Entitlements

अपने Dodo Payments dashboard में Entitlements पर जाएँ और नया entitlement बनाने के लिए + पर click करें।

2

Choose Digital Files

Integration के रूप में Digital Product Delivery चुनें।

3

Add files, links, and instructions

इनमें से किसी भी combination को configure करें:

• Files: एक या अधिक फ़ाइलें upload करें। हर upload एक file_id लौटाता है, जिसे entitlement में append किया जाता है।
• External URL: hosted फ़ाइलों के साथ डिलीवर किया जाने वाला publicly reachable HTTPS link।
• Instructions: customer को दिखाया जाने वाला free-form text (जैसे, “Unzip and run setup.sh”)।

4

Save the entitlement

Save करें। अब entitlement किसी भी product से attach करने के लिए उपलब्ध है।

​

Products से attach करें

​

Delivery कैसे काम करती है

​

Customer Experience

​

Purchase Confirmation

​

Customer Portal Access

​

Programmatically Files manage करें

​

Entitlement पर file upload करें

import DodoPayments from 'dodopayments';
import fs from 'node:fs';

const client = new DodoPayments({
  bearerToken: process.env['DODO_PAYMENTS_API_KEY'],
  environment: 'test_mode',
});

await client.entitlements.files.upload('ent_files_abc', {
  file: fs.createReadStream('./pro-bundle.zip'),
  filename: 'pro-bundle.zip',
});

curl -X POST "https://test.dodopayments.com/entitlements/ent_files_abc/files" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@./pro-bundle.zip" \
  -F "filename=pro-bundle.zip"

​

Grants list करें और download URLs resolve करें

const grants = await client.entitlements.grants.list('ent_files_abc', {
  customer_id: 'cus_abc123',
});

for (const grant of grants.items) {
  for (const file of grant.digital_product_delivery.files) {
    console.log(file.filename, file.download_url, `expires in ${file.expires_in}s`);
  }
}

​

Entitlement से file हटाएँ

await client.entitlements.files.delete('df_a4f6c1de', { id: 'ent_files_abc' });

​

महत्वपूर्ण बातें

• Presigned URLs जल्दी expire होते हैं। Grant payloads या webhook events में लौटाए गए download URLs लगभग 15 मिनट तक valid होते हैं। इन्हें store न करें; customer को दोबारा download करने की ज़रूरत होने पर फिर से fetch करें।
• Files update करने से केवल future purchases प्रभावित होती हैं। किसी file को replace या remove करने से पहले से जारी downloads में retroactively बदलाव नहीं होता। पुराने customers अभी भी उस version को फिर से fetch कर सकते हैं जो उनका grant बनाए जाने के समय current था।
• Refunds, downloaded copies को invalidate नहीं करते। जिस customer ने file पहले ही download कर ली है, उसके पास वह copy बनी रहती है। Revocable content (license-restricted media, time-limited access) के लिए Digital Files को License Keys के साथ इस्तेमाल करें और runtime पर validate करें।
• Sensitive content के लिए अपनी auth वाले external URLs को प्राथमिकता दें। Dodo Payments के presigned URLs short-lived होते हैं, लेकिन अपनी validity window में unauthenticated रहते हैं; जिसके पास URL है, वह उस window में download कर सकता है। Externally hosted, account-gated content अधिक मजबूत guarantees देता है।

​

API Management

​

Webhooks

"digital_product_delivery": {
  "files": [
    {
      "file_id": "df_a4f6c1de",
      "download_url": "https://files.dodopayments.com/.../pro-bundle.zip?Signature=...",
      "filename": "pro-bundle.zip",
      "content_type": "application/zip",
      "file_size": 18742390,
      "expires_in": 900
    }
  ],
  "instructions": "Unzip and run setup.sh from the project root.",
  "external_url": null
}

​

Legacy Digital Product Delivery

​

Best Practices

• Downloads को one-shot मानें। Customers links share या lose कर सकते हैं, इसलिए अपने product को इस assumption के आधार पर design करें कि वे जो भी download करेंगे, उसे अपने पास रखेंगे।
• Expectations सेट करने के लिए instructions का उपयोग करें। Multi-file bundles के लिए एक instructions line जोड़ें, जिसमें बताया गया हो कि पहले क्या install करना है या files को कैसे combine करना है।
• 500 MiB cap का ध्यान रखें। बड़ी artifacts (multi-GB datasets, video courses) को externally host करें और upload करने के बजाय external_url के ज़रिए link करें।
• Revocable access के लिए License Keys के साथ combine करें। यदि refund के बाद in-product features का access revoke करना हो, तो Digital Files entitlement को License Key entitlement के साथ pair करें और runtime पर key validate करें।
• Customer Portal refresh flow को test करें। सुनिश्चित करें कि customer एक सप्ताह बाद portal पर लौटकर भी working download link प्राप्त कर सके। Email links expire होने पर यही primary recovery path है।