Digital Product Delivery

​

Overview

• Unggahan file yang di-host: Dodo Payments menyimpan file Anda dan menyediakannya melalui presigned URL berumur pendek.
• Tautan unduhan eksternal: satu URL per entitlement yang mengarah ke file yang di-host di tempat lain, seperti Dropbox, Google Drive, atau S3.
• Instruksi unduhan: teks bebas yang ditampilkan kepada pelanggan di halaman pesanan dan email pengiriman.

​

Fitur Utama

​

Menyiapkan Digital Product Delivery

1

Open Entitlements

Buka Entitlements di dashboard dan klik + untuk membuat entitlement.

2

Choose Digital Files

Pilih Digital Files dan masukkan Name untuk entitlement.

3

Add Files, Links, and Instructions

Konfigurasikan kombinasi apa pun dari kolom berikut:

• Upload files: unggah satu atau beberapa file. Setiap unggahan mengembalikan file_id dan menambahkan file ke digital_file_ids milik entitlement.
• External Download Link: URL yang diawali dengan http:// atau https://, yang dapat diakses pelanggan. Dodo Payments mengirimkannya bersama file yang di-host.
• Instructions: teks bebas yang ditampilkan kepada pelanggan, misalnya “Unzip and run setup.sh.”

4

Save the Entitlement

Klik Create Entitlement. Sekarang Anda dapat melampirkan entitlement tersebut ke produk apa pun.

​

Melampirkan ke Produk

​

Cara Kerja Pengiriman

​

Pengalaman Pelanggan

​

Konfirmasi Pembelian

​

Akses Portal Pelanggan

​

Mengelola File Secara Program

​

Mengunggah File ke 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"

​

Mencantumkan Grant dan Menyelesaikan URL Unduhan

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

​

Menghapus File dari Entitlement

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

​

Pertimbangan Penting

• Presigned URL cepat kedaluwarsa. URL unduhan dalam payload grant dan event webhook berlaku selama 15 menit. Jangan menyimpannya. Ambil URL baru saat pelanggan perlu mengunduh kembali.
• Pembaruan file hanya memengaruhi pembelian berikutnya. Mengganti atau menghapus file tidak mengubah unduhan yang telah diterbitkan. Setiap grant menyimpan konfigurasi entitlement saat grant dibuat, sehingga pelanggan lama tetap dapat memperoleh versi yang berlaku saat itu.
• Refund tidak membatalkan salinan yang telah diunduh. Pelanggan yang sudah mengunduh file tetap memiliki salinan tersebut. Untuk konten yang dapat dicabut, seperti media yang dibatasi lisensi atau akses berbatas waktu, pasangkan Digital Files dengan License Keys dan validasi key saat runtime.
• Untuk konten sensitif, utamakan URL eksternal dengan autentikasi sendiri. Presigned URL dari Dodo Payments berumur pendek, tetapi siapa pun yang memiliki URL dapat mengunduh file hingga URL tersebut kedaluwarsa. Konten yang di-host secara eksternal di balik login akun memberi Anda lebih banyak kontrol.

​

Manajemen 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 Lama

​

Praktik Terbaik

• Perlakukan unduhan sebagai pengiriman satu kali. Pelanggan dapat membagikan atau kehilangan tautan, jadi rancang produk Anda dengan asumsi bahwa apa pun yang mereka unduh menjadi milik mereka untuk disimpan.
• Gunakan instruksi untuk menetapkan ekspektasi. Untuk bundel multi-file, tambahkan baris instructions yang menjelaskan hal yang harus diinstal terlebih dahulu atau cara menggabungkan file.
• Perhatikan batas 500 MiB. Host artefak yang lebih besar, seperti dataset multi-GB atau kursus video, secara eksternal, lalu tautkan dengan external_url, bukan dengan mengunggahnya.
• Gabungkan dengan License Keys untuk akses yang dapat dicabut. Untuk mencabut akses ke fitur dalam produk setelah refund, pasangkan entitlement Digital Files dengan entitlement License Key dan validasi key saat runtime.
• Uji alur refresh Customer Portal. Pastikan pelanggan dapat kembali ke portal seminggu kemudian dan tetap memperoleh tautan unduhan yang berfungsi. Portal adalah jalur pemulihan utama ketika tautan email kedaluwarsa.