Digital Product Delivery

​

Overview

• ホストされたファイルのアップロード: Dodo Payments がファイルを保存し、短期間有効な presigned URL を通じて提供します。
• 外部ダウンロードリンク: Dropbox、Google Drive、S3 など、別の場所でホストされているファイルを指す、entitlement ごとに 1 つの URL。
• ダウンロード手順: 注文ページと配信メールに表示される、自由形式のテキスト。

​

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: 1 つ以上のファイルをアップロードします。各アップロードは file_id を返し、そのファイルを entitlement の digital_file_ids に追加します。
• External Download Link: http:// または https:// で始まる、顧客がアクセスできる URL。Dodo Payments はホストされたファイルとともにこの URL を配信します。
• Instructions: 顧客に表示する自由形式のテキスト。例: “Unzip and run setup.sh.”

4

Save the Entitlement

Create Entitlement をクリックします。これで、任意の商品に entitlement を紐付けられるようになります。

​

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 の一覧表示とダウンロード 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 に含まれるダウンロード URL は 15 分間有効です。保存しないでください。顧客が再度ダウンロードする必要があるときに、新しい URL を取得してください。
• ファイルの更新は今後の購入にのみ影響します。 ファイルを置き換えたり削除したりしても、すでに発行されたダウンロードには影響しません。各 grant は作成時点の entitlement 設定を保持するため、過去の顧客は当時のバージョンを引き続き取得できます。
• Refund によってダウンロード済みのコピーが無効になることはありません。 すでにファイルをダウンロードした顧客は、そのコピーを保持します。ライセンスで制限されたメディアや期間限定アクセスなど、revoke 可能なコンテンツには、Digital Files と License Keys を組み合わせ、runtime で key を検証してください。
• 機密性の高いコンテンツには、独自の認証を備えた外部 URL を推奨します。 Dodo Payments の presigned URL は短期間のみ有効ですが、URL を知っている人は有効期限が切れるまでファイルをダウンロードできます。アカウントログインの背後に外部ホストされたコンテンツを配置すると、より細かく制御できます。

​

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

​

ベストプラクティス

• ダウンロードは一度限りの配信として扱います。 顧客はリンクを共有したり紛失したりする可能性があるため、ダウンロードしたものは顧客が保持すると想定して商品を設計してください。
• 手順を使用して期待値を設定します。 複数ファイルのバンドルでは、何を最初にインストールするか、またはファイルをどのように組み合わせるかを説明する instructions 行を追加してください。
• 500 MiB の上限に注意します。 数 GB のデータセットや動画コースなど、より大きな成果物は外部でホストし、アップロードする代わりに external_url でリンクしてください。
• revoke 可能なアクセスには License Keys を組み合わせます。 Refund 後に商品内機能へのアクセスを revoke するには、Digital Files entitlement と License Key entitlement を組み合わせ、runtime で key を検証してください。
• Customer Portal の refresh flow をテストします。 顧客が 1 週間後に portal に戻っても、機能するダウンロードリンクを取得できることを確認してください。メールリンクの有効期限が切れた場合、portal が主な復旧手段になります。