Digital Product Delivery

​

Overview

• Hosted file uploads: Dodo Payments가 파일을 저장하고 단기 유효 presigned URL을 통해 제공합니다.
• External download link: Dropbox, Google Drive 또는 S3와 같이 다른 곳에 호스팅된 파일을 가리키는 entitlement당 하나의 URL입니다.
• Download instructions: customer의 order page와 delivery email에 표시되는 자유 형식 텍스트입니다.

​

Key Features

​

Digital Product Delivery 설정

1

Open Entitlements

dashboard에서 Entitlements로 이동하고 **+**를 클릭하여 entitlement를 생성합니다.

2

Choose Digital Files

Digital Files를 선택하고 entitlement의 Name을 입력합니다.

3

Add Files, Links, and Instructions

다음 필드를 원하는 조합으로 구성합니다:

• Upload files: 하나 이상의 파일을 업로드합니다. 각 업로드는 file_id을 반환하고 파일을 entitlement의 digital_file_ids에 추가합니다.
• External Download Link: customer가 접근할 수 있는 http:// 또는 https://로 시작하는 URL입니다. Dodo Payments는 이 URL을 호스팅된 파일과 함께 전달합니다.
• Instructions: customer에게 표시되는 자유 형식 텍스트입니다. 예를 들어 “Unzip and run setup.sh.”와 같이 입력할 수 있습니다.

4

Save the Entitlement

Create Entitlement를 클릭합니다. 이제 이 entitlement를 모든 product에 연결할 수 있습니다.

​

Attach to Products

​

How Delivery Works

​

Customer Experience

​

Purchase Confirmation

​

Customer Portal Access

​

Manage Files Programmatically

​

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"

​

Grant 나열 및 Download URL 확인

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에서 파일 제거

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

​

주요 고려 사항

• Presigned URL은 빠르게 만료됩니다. grant payload와 webhook event의 download URL은 15분 동안 유효합니다. 이를 저장하지 마세요. customer가 다시 다운로드해야 할 때 새로운 URL을 가져오세요.
• 파일 업데이트는 향후 purchase에만 영향을 줍니다. 파일을 교체하거나 제거해도 이미 발급된 다운로드는 변경되지 않습니다. 각 grant는 생성 당시의 entitlement configuration을 유지하므로 기존 customer는 당시 사용 가능했던 version을 계속 받을 수 있습니다.
• Refund는 다운로드한 사본을 무효화하지 않습니다. 이미 파일을 다운로드한 customer는 해당 사본을 계속 보유합니다. license로 제한된 media나 기간 제한 access처럼 취소 가능한 content의 경우 Digital Files를 License Keys와 함께 사용하고 runtime에 key를 검증하세요.
• 민감한 content에는 자체 authentication을 사용하는 external URL을 우선 사용하세요. Dodo Payments의 presigned URL은 단기 유효하지만 URL을 가진 사람은 누구나 만료될 때까지 파일을 다운로드할 수 있습니다. account login 뒤에 외부 호스팅된 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

• 다운로드를 일회성 delivery로 취급하세요. customer는 link를 공유하거나 잃어버릴 수 있으므로, 다운로드한 모든 content를 customer가 계속 보유한다고 가정하고 product를 설계하세요.
• instructions를 사용하여 기대치를 설정하세요. 여러 파일로 구성된 bundle의 경우 무엇을 먼저 설치해야 하는지 또는 파일을 어떻게 결합해야 하는지 설명하는 instructions line을 추가하세요.
• 500 MiB 제한에 유의하세요. 여러 GB의 dataset이나 video course와 같은 더 큰 artifact는 외부에서 호스팅하고 업로드하는 대신 external_url로 연결하세요.
• 취소 가능한 access에는 License Keys를 함께 사용하세요. refund 후 product 내 feature에 대한 access를 취소하려면 Digital Files entitlement를 License Key entitlement와 함께 사용하고 runtime에 key를 검증하세요.
• Customer Portal refresh flow를 테스트하세요. customer가 일주일 후 portal로 돌아와도 여전히 작동하는 download link를 받을 수 있는지 확인하세요. 이메일 link가 만료되었을 때 portal은 주요 복구 경로입니다.