Digital Product Delivery

​

अवलोकन

• Hosted file uploads: Dodo Payments आपकी files को store करता है और उन्हें short-lived presigned URLs के ज़रिए उपलब्ध कराता है।
• External download link: प्रत्येक entitlement के लिए एक URL, जो कहीं और hosted files, जैसे Dropbox, Google Drive या S3, पर ले जाता है।
• Download instructions: free-form text, जो customer को उनके order page और delivery email में दिखाई देता है।

​

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

​

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

1

Open Entitlements

Dashboard में Entitlements पर जाएँ और entitlement बनाने के लिए + पर click करें।

2

Choose Digital Files

Digital Files चुनें और entitlement के लिए Name दर्ज करें।

3

Add Files, Links, and Instructions

इन fields में से किसी भी संयोजन को configure करें:

• Upload files: एक या अधिक files upload करें। प्रत्येक upload एक file_id लौटाता है और file को entitlement के digital_file_ids में जोड़ता है।
• External Download Link: ऐसा URL, जो http:// या https:// से शुरू होता है और customers उस तक पहुँच सकते हैं। Dodo Payments इसे hosted files के साथ डिलीवर करता है।
• Instructions: customer को दिखाया जाने वाला free-form text, उदाहरण के लिए “Unzip and run setup.sh.”

4

Save the Entitlement

Create Entitlement पर click करें। अब आप entitlement को किसी भी product से जोड़ सकते हैं।

​

Products से attach करें

​

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

​

Customer Experience

​

Purchase Confirmation

​

Customer Portal Access

​

Programmatically Files manage करें

​

Entitlement में File Upload करें

import DodoPayments from 'dodopayments';
import { openAsBlob } from 'node:fs'; // Node.js 20 or later

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

// The SDK sends a FormData body as multipart/form-data. Append `filename` before `file`.
const form = new FormData();
form.append('filename', 'pro-bundle.zip');
form.append('file', await openAsBlob('./pro-bundle.zip'), 'pro-bundle.zip');

const { file_id } = await client.entitlements.files.upload('ent_files_abc', { body: form });
console.log(file_id);

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

​

Grants की सूची बनाएँ और 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('YOUR_FILE_ID', { id: 'ent_files_abc' });

​

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

• Presigned URLs जल्दी expire हो जाते हैं। Grant payloads और webhook events में मौजूद Download URLs 15 मिनट तक valid रहते हैं। उन्हें store न करें। Customer को दोबारा download करने की आवश्यकता होने पर नए URLs fetch करें।
• Files को update करने से केवल future purchases प्रभावित होती हैं। किसी file को replace या remove करने से पहले जारी किए गए downloads नहीं बदलते। प्रत्येक grant अपने बनाए जाने के समय की entitlement configuration रखता है, इसलिए पुराने customers को उस समय का current version अभी भी मिल सकता है।
• Refunds downloaded copies को invalidate नहीं करते। जिस customer ने file पहले ही download कर ली है, उसके पास वह copy बनी रहती है। Revocable content, जैसे license-restricted media या time-limited access, के लिए Digital Files को License Keys के साथ pair करें और runtime पर key validate करें।
• Sensitive content के लिए अपनी authentication वाले external URLs को प्राथमिकता दें। Dodo Payments के presigned URLs short-lived होते हैं, लेकिन URL रखने वाला कोई भी व्यक्ति उसके expire होने तक file download कर सकता है। Account login के पीछे externally hosted content आपको अधिक नियंत्रण देता है।

​

API Management

​

Webhooks

"digital_product_delivery": {
  "files": [
    {
      "file_id": "YOUR_FILE_ID",
      "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-time deliveries मानें। Customers links share या lose कर सकते हैं, इसलिए अपना product इस धारणा के आधार पर design करें कि वे जो भी download करते हैं, वह उनके पास रखने के लिए है।
• Expectations तय करने के लिए instructions का उपयोग करें। Multi-file bundles के लिए एक instructions line जोड़ें, जिसमें बताया गया हो कि पहले क्या install करना है या files को कैसे combine करना है।
• 500 MiB limit का ध्यान रखें। Multi-GB datasets या video courses जैसे बड़े artifacts को 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 होने पर portal मुख्य recovery path है।