Digital Product Delivery

​

Overview

• Tải tệp được lưu trữ: Dodo Payments lưu trữ tệp của bạn và cung cấp chúng thông qua các presigned URL có thời hạn ngắn.
• Liên kết tải xuống bên ngoài: một URL cho mỗi entitlement, trỏ đến các tệp được lưu trữ ở nơi khác, chẳng hạn như Dropbox, Google Drive hoặc S3.
• Hướng dẫn tải xuống: văn bản tự do hiển thị cho khách hàng trên trang đơn hàng và trong email giao hàng.

​

Key Features

​

Thiết lập Digital Product Delivery

1

Open Entitlements

Đi đến Entitlements trong dashboard và nhấp vào + để tạo một entitlement.

2

Choose Digital Files

Chọn Digital Files và nhập Name cho entitlement.

3

Add Files, Links, and Instructions

Cấu hình bất kỳ tổ hợp nào của các trường sau:

• Upload files: tải lên một hoặc nhiều tệp. Mỗi lần tải lên trả về một file_id và thêm tệp vào digital_file_ids của entitlement.
• External Download Link: một URL bắt đầu bằng http:// hoặc https:// mà khách hàng có thể truy cập. Dodo Payments cung cấp URL này cùng với các tệp được lưu trữ.
• Instructions: văn bản tự do hiển thị cho khách hàng, ví dụ: “Giải nén và chạy setup.sh.”

4

Save the Entitlement

Nhấp vào Create Entitlement. Bây giờ bạn có thể gắn entitlement này vào bất kỳ sản phẩm nào.

​

Attach to Products

​

How Delivery Works

​

Customer Experience

​

Purchase Confirmation

​

Customer Portal Access

​

Manage Files Programmatically

​

Tải tệp lên một Entitlement

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"

​

Liệt kê Grant và phân giải URL tải xuống

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

​

Xóa tệp khỏi Entitlement

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

​

Những điều cần lưu ý

• Presigned URL hết hạn nhanh. URL tải xuống trong payload của grant và webhook event có hiệu lực trong 15 phút. Đừng lưu trữ chúng. Hãy fetch URL mới khi khách hàng cần tải xuống lần nữa.
• Việc cập nhật tệp chỉ ảnh hưởng đến các lần mua trong tương lai. Thay thế hoặc xóa tệp không làm thay đổi các lượt tải xuống đã được cấp. Mỗi grant giữ cấu hình entitlement tại thời điểm được tạo, vì vậy khách hàng trước đây vẫn có thể nhận phiên bản đã hiện hành vào thời điểm đó.
• Hoàn tiền không làm mất hiệu lực các bản sao đã tải xuống. Khách hàng đã tải tệp xuống vẫn giữ bản sao đó. Đối với nội dung có thể thu hồi, chẳng hạn như media bị giới hạn bởi license hoặc quyền truy cập có thời hạn, hãy kết hợp Digital Files với License Keys và xác thực key trong runtime.
• Đối với nội dung nhạy cảm, nên ưu tiên URL bên ngoài có cơ chế authentication riêng. Presigned URL từ Dodo Payments có thời hạn ngắn, nhưng bất kỳ ai có URL đều có thể tải tệp xuống cho đến khi URL hết hạn. Nội dung được lưu trữ bên ngoài và yêu cầu đăng nhập tài khoản giúp bạn kiểm soát tốt hơn.

​

Quản lý API

​

Webhook

"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
}

​

Digital Product Delivery cũ

​

Best Practices

• Coi các lượt tải xuống là những lần cung cấp một lần. Khách hàng có thể chia sẻ hoặc làm mất liên kết, vì vậy hãy thiết kế sản phẩm với giả định rằng mọi thứ họ tải xuống đều thuộc quyền lưu giữ của họ.
• Sử dụng hướng dẫn để thiết lập kỳ vọng. Đối với các gói gồm nhiều tệp, hãy thêm một dòng instructions giải thích cần cài đặt gì trước hoặc cách kết hợp các tệp.
• Lưu ý giới hạn 500 MiB. Lưu trữ các artifact lớn hơn, chẳng hạn như dataset nhiều GB hoặc khóa học video, ở bên ngoài và liên kết chúng bằng external_url thay vì tải lên.
• Kết hợp với License Keys để có quyền truy cập có thể thu hồi. Để 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, hãy kết hợp entitlement Digital Files với entitlement License Key và xác thực key trong runtime.
• Kiểm tra flow làm mới của Customer Portal. Xác nhận rằng khách hàng có thể quay lại portal một tuần sau đó và vẫn nhận được liên kết tải xuống hoạt động. Portal là phương án khôi phục chính khi các liên kết email hết hạn.