Consegna di Prodotti Digitali

​

Panoramica

• Caricamenti di file ospitati: Dodo Payments archivia i file e li distribuisce tramite URL presigned a breve durata.
• Link di download esterno: un URL per entitlement che rimanda a file ospitati altrove, ad esempio su Dropbox, Google Drive o S3.
• Istruzioni per il download: testo libero mostrato al cliente nella pagina dell’ordine e nell’email di consegna.

​

Caratteristiche Principali

​

Configurare Digital Product Delivery

1

Open Entitlements

Vai a Entitlements nel dashboard e fai clic su + per creare un entitlement.

2

Choose Digital Files

Seleziona Digital Files e inserisci un Name per l’entitlement.

3

Add Files, Links, and Instructions

Configura una combinazione qualsiasi di questi campi:

• Upload files: carica uno o più file. Ogni caricamento restituisce un file_id e aggiunge il file alla digital_file_ids dell’entitlement.
• External Download Link: un URL che inizia con http:// o https://, raggiungibile dai clienti. Dodo Payments lo distribuisce insieme ai file ospitati.
• Instructions: testo libero mostrato al cliente, ad esempio “Decomprimi ed esegui setup.sh.”

4

Save the Entitlement

Fai clic su Create Entitlement. Ora puoi associare l’entitlement a qualsiasi prodotto.

​

Allegare ai Prodotti

​

Come Funziona la Consegna

​

Esperienza del Cliente

​

Conferma Acquisto

​

Accesso al Portale Clienti

​

Gestione Programmata dei File

​

Caricare un file in un 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"

​

Elencare le concessioni e risolvere gli URL di download

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

​

Rimuovere un file da un entitlement

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

​

Considerazioni importanti

• Gli URL presigned scadono rapidamente. Gli URL di download nei payload delle concessioni e negli eventi webhook sono validi per 15 minuti. Non salvarli. Recupera nuovi URL quando il cliente deve scaricare nuovamente il file.
• L’aggiornamento dei file influisce solo sugli acquisti futuri. La sostituzione o la rimozione di un file non modifica i download già emessi. Ogni concessione conserva la configurazione dell’entitlement presente al momento della sua creazione, quindi i clienti precedenti possono ancora ottenere la versione disponibile in quel momento.
• I rimborsi non invalidano le copie scaricate. Un cliente che ha già scaricato un file conserva quella copia. Per contenuti revocabili, come media soggetti a restrizioni di licenza o accessi a tempo limitato, associa Digital Files a License Keys e convalida la chiave a runtime.
• Per i contenuti sensibili, preferisci URL esterni con una propria autenticazione. Gli URL presigned di Dodo Payments hanno una durata breve, ma chiunque disponga dell’URL può scaricare il file fino alla sua scadenza. I contenuti ospitati esternamente e protetti da un accesso con account offrono un maggiore controllo.

​

Gestione 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 legacy

​

Best practice

• Considera i download come consegne una tantum. I clienti possono condividere o perdere i link, quindi progetta il prodotto partendo dal presupposto che tutto ciò che scaricano resterà in loro possesso.
• Usa le istruzioni per definire le aspettative. Per i bundle con più file, aggiungi una riga instructions che spieghi cosa installare per primo o come combinare i file.
• Tieni conto del limite di 500 MiB. Ospita esternamente gli artifact più grandi, come dataset di diversi GB o corsi video, e collegali con external_url invece di caricarli.
• Combina con License Keys per l’accesso revocabile. Per revocare l’accesso alle funzionalità del prodotto dopo un rimborso, associa l’entitlement Digital Files a un entitlement License Key e convalida la chiave a runtime.
• Testa il flusso di aggiornamento del Customer Portal. Verifica che un cliente possa tornare al portale una settimana dopo e ottenere ancora un link di download funzionante. Il portale è il principale percorso di recupero quando i link email scadono.