Digital Product Delivery - Dodo Payments Documentation

Overview

Digital Product Delivery is the Digital Files entitlement type. You upload your files once to a Digital Files entitlement, attach the entitlement to a product, and Dodo Payments delivers presigned download links to every paying customer through email and the customer portal. The entitlement supports:

Hosted file uploads: store files on Dodo Payments and serve them via short-lived presigned URLs.
External download links: link to files hosted on Dropbox, Google Drive, S3, or any URL.
Download instructions: free-form text shown to the customer on their order page and in the delivery email.

You can mix all three on a single entitlement.

Key Features

File Upload

Tải tệp (PDF, ZIP, hình ảnh, video, v.v.) lên tới 500 MiB. Các tệp được truyền và lưu trữ hiệu quả.

Multiple Files

Attach as many files as you need to a single entitlement.

External Links

Provide external download links (Dropbox, Google Drive, signed S3 URLs) as an alternative or addition.

Presigned URLs

Hosted files are served via short-lived presigned URLs. Each download URL expires automatically after roughly 15 minutes.

Set up Digital Product Delivery

Open Entitlements

Go to Entitlements in your Dodo Payments dashboard and click + to create a new entitlement.

Choose Digital Files

Select Digital Product Delivery as the integration.

Add files, links, and instructions

Configure any combination of:

Files: upload one or more files. Each upload returns a file_id that’s appended to the entitlement.
External URL: a publicly reachable HTTPS link delivered alongside hosted files.
Instructions: free-form text shown to the customer (e.g., “Unzip and run setup.sh”).

Digital Files entitlement with file upload, external URL, and instructions fields

Save the entitlement

Save. The entitlement is now available to attach to any product.

Attach to Products

Open a product, expand Advanced Settings → Entitlements & Credits, and select your Digital Files entitlement. The entitlement is delivered on every successful purchase or active subscription tied to that product.

Product entitlements panel showing Digital Product Delivery selected

How Delivery Works

Digital Files delivery follows the standard grant lifecycle:

Event	Behavior
`payment.succeeded` (one-time)	Issue a grant. The grant carries presigned download URLs valid for ~15 minutes; customers can refresh them by reopening the email link or the customer portal page.
`subscription.active`	Issue a grant. Files remain accessible while the subscription is active.
`subscription.renewed`	No-op. The same grant continues; new presigned URLs are minted on every fetch.
`subscription.on_hold` / `cancelled` / `expired`	Revoke the grant. New presigned URLs are no longer issued.
`subscription.plan_changed`	Revoke the old grant; issue a new one for the new plan’s entitlement.
`refund.succeeded` (one-time)	Revoke the grant.
Manual revoke	Revoke with `revocation_reason: manual`.

Revocation stops Dodo Payments from issuing new download URLs, but it does not invalidate copies a customer has already downloaded. Treat hosted file downloads as “delivered once read.”

Customer Experience

Purchase Confirmation

After a successful transaction, the customer receives an email with download links and any instructions you configured.

Customer Portal Access

Customers can re-fetch download links anytime from the Customer Portal. The portal page generates fresh presigned URLs on demand, so the same purchase keeps working even after the email’s links have expired.

Customer portal interface showing available digital products for download

Customers can download files directly from confirmation emails or access them anytime through their portal.

Manage Files Programmatically

Upload a file to an entitlement

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"

List grants and resolve download URLs

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`);
  }
}

Remove a file from an entitlement

await client.entitlements.files.delete('ent_files_abc', 'df_a4f6c1de');

Important Considerations

Presigned URLs expire quickly. Download URLs returned in grant payloads or webhook events are valid for ~15 minutes. Don’t store them; re-fetch them when the customer needs to download again.
Updating files affects future purchases only. Replacing or removing a file does not retroactively change downloads already issued. Past customers can still re-fetch the version that was current when their grant was created.
Refunds don’t invalidate downloaded copies. A customer who already downloaded a file keeps that copy. For revocable content (license-restricted media, time-limited access), pair Digital Files with License Keys and validate at runtime.
For sensitive content, prefer external URLs with their own auth. Dodo Payments’ presigned URLs are short-lived but unauthenticated within their window; anyone with the URL can download in that window. Externally hosted, account-gated content provides stronger guarantees.

API Management

Create Entitlement

Tạo quyền truy cập tệp kỹ thuật số với URL bên ngoài và hướng dẫn tùy chọn.

Upload File

Tải một tệp (tối đa 500 MiB) và đính kèm vào quyền truy cập.

Delete File

Xóa một tệp khỏi quyền truy cập.

List Grants

Liệt kê các quyền và đọc URL tải về đã được giải quyết.

Update Entitlement

Cập nhật hướng dẫn, URL bên ngoài, hoặc thay thế tệp.

Revoke Grant

Thu hồi quyền truy cập của khách hàng một cách thủ công.

Webhooks

Digital file delivery and revocation fire the four entitlement_grant.* webhook events. For Digital Files grants, the payload includes a digital_product_delivery object with the resolved file list (presigned URLs, filenames, sizes), the optional instructions, and the optional external_url.

"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

Products configured with the older digital_product_delivery block on the product itself have been automatically migrated to a Digital Files entitlement. Existing files uploaded under the legacy product file API are preserved; they continue to be downloadable and appear in grant payloads tagged with source: "legacy". Future updates (adding files, changing instructions, replacing the external URL) should be made by editing the migrated Digital Files entitlement under Entitlements.The legacy product-level fields (digital_product_delivery.external_url, digital_product_delivery.instructions) continue to be populated on product responses for backwards compatibility, but the entitlement is the source of truth going forward.

Best Practices

Xem xét tải xuống là một lần duy nhất. Khách hàng sẽ chia sẻ hoặc mất liên kết, vì vậy hãy thiết kế sản phẩm của bạn dựa trên giả định rằng bất cứ thứ gì họ tải xuống là của họ.
Sử dụng hướng dẫn để đặt kỳ vọng. Đối với các gói tệp nhiều, thêm một dòng instructions để giải thích cài đặt gì trước hoặc cách kết hợp các tệp.
Chú ý giới hạn 500 MiB. Các vật phẩm lớn hơn (bộ dữ liệu nhiều GB, khóa học video) nên được lưu trữ bên ngoài và liên kết thông qua external_url thay vì tải lên.
Kết hợp với Khóa Giấy Phép để thu hồi quyền truy cập. Nếu bạn cần thu hồi quyền truy cập vào các tính năng trong sản phẩm sau khi hoàn tiền, kết hợp quyền truy cập Tệp Kỹ thuật số với quyền Khóa Giấy Phép và xác thực khóa khi chạy.
Kiểm tra luồng làm mới cổng khách hàng. Xác nhận khách hàng có thể trở lại cổng một tuần sau đó và vẫn nhận được liên kết tải xuống hoạt động. Đây là con đường khôi phục chính khi các liên kết email hết hạn.

​Overview

​Key Features

File Upload

Multiple Files

External Links

Presigned URLs

​Set up Digital Product Delivery

​Attach to Products

​How Delivery Works

​Customer Experience

​Purchase Confirmation

​Customer Portal Access

​Manage Files Programmatically

​Upload a file to an entitlement

​List grants and resolve download URLs

​Remove a file from an entitlement

​Important Considerations

​API Management

Create Entitlement

Upload File

Delete File

List Grants

Update Entitlement

Revoke Grant

​Webhooks

​Legacy Digital Product Delivery

​Best Practices

Overview

Key Features

Set up Digital Product Delivery

Attach to Products

How Delivery Works

Customer Experience

Purchase Confirmation

Customer Portal Access

Manage Files Programmatically

Upload a file to an entitlement

List grants and resolve download URLs

Remove a file from an entitlement

Important Considerations

API Management

Webhooks

Legacy Digital Product Delivery

Best Practices