デジタル製品の配信

​

概要

• ホストされたファイルのアップロード：ファイルをDodo Paymentsに保存し、短期間の署名付きURLを介して提供します。
• 外部ダウンロードリンク：Dropbox、Google Drive、S3、または任意のURLにホストされたファイルへのリンク。
• ダウンロード手順：注文ページと配信メールに表示される自由形式のテキスト。

​

主な特徴

​

デジタル製品配信のセットアップ

• ファイル：1つまたは複数のファイルをアップロードします。各アップロードは権利に追加されるfile_idを返します。
• 外部URL：ホストされたファイルと一緒に配信される公開アクセス可能なHTTPSリンク。
• 手順：顧客に表示される自由形式のテキスト（例：「解凍してsetup.shを実行する」）。

​

製品に添付

​

配信方法

​

顧客体験

​

購入確認

​

カスタマーポータルアクセス

​

プログラムによるファイル管理

​

権利にファイルをアップロードする

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"

​

権利を一覧表示しダウンロード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`);
  }
}

​

権利からファイルを削除する

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

​

重要な考慮事項

• 署名付きURLはすぐに期限切れになります。 権利ペイロードまたはWebhookイベントで返されるダウンロードURLは約15分間有効です。それらを保存せず、顧客が再度ダウンロードする必要があるときに再取得してください。
• ファイルの更新は将来の購入にのみ影響します。 ファイルを置き換えたり削除したりしても、すでに発行されているダウンロードに遡及して変更はありません。過去の顧客は、権利が作成された時点で現在だったバージョンを再取得できます。
• 払い戻しはダウンロードされたコピーを無効にしません。 すでにファイルをダウンロードした顧客はそのコピーを保持します。取り消し可能なコンテンツ（ライセンス制限メディア、期間限定アクセス）には、デジタルファイルをライセンスキーと連携し、実行時に検証してください。
• 機密性の高いコンテンツには独自の認証を備えた外部URLを好ましく使用してください。 Dodo Paymentsの署名付きURLは短期間ですが、その間は認証されていないため、そのURLを持っている誰でもその期間にダウンロードできます。外部ホストされたアカウントゲートコンテンツはより強力な保証を提供します。

​

API管理

​

Webhooks

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

​

レガシーデジタル製品配信