Consegna di Prodotti Digitali

​

Panoramica

• Caricamenti di file ospitati: memorizza i file su Dodo Payments e fornisce loro tramite URL presigned a breve durata.
• Link di download esterni: collega a file ospitati su Dropbox, Google Drive, S3 o qualsiasi URL.
• Istruzioni di download: testo libero mostrato al cliente sulla pagina dell’ordine e nell’email di consegna.

​

Caratteristiche Principali

​

Configura Consegna di Prodotti Digitali

1

Open Entitlements

Vai su Autorizzazioni nel dashboard di Dodo Payments e fai clic su + per creare una nuova autorizzazione.

2

Choose Digital Files

Seleziona Consegna di Prodotti Digitali come integrazione.

3

Add files, links, and instructions

Configura qualsiasi combinazione di:

• File: carica uno o più file. Ogni caricamento restituisce un file_id che viene aggiunto all’autorizzazione.
• URL esterno: un link HTTPS pubblicamente raggiungibile consegnato insieme ai file ospitati.
• Istruzioni: testo libero mostrato al cliente (ad es., “Decomprimi ed esegui setup.sh”).

4

Save the entitlement

Salva. L’autorizzazione è ora disponibile per essere allegata a qualsiasi prodotto.

​

Allegare ai Prodotti

​

Come Funziona la Consegna

​

Esperienza del Cliente

​

Conferma Acquisto

​

Accesso al Portale Clienti

​

Gestione Programmata dei File

​

Carica un file su un’autorizzazione

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"

​

Elenca concessioni e risolvi 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`);
  }
}

​

Rimuovi un file da un’autorizzazione

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

​

Considerazioni Importanti

• Gli URL presigned scadono velocemente. Gli URL di download restituiti nei payload delle concessioni o negli eventi webhook sono validi per ~15 minuti. Non memorizzarli; recuperali nuovamente quando il cliente deve scaricare di nuovo.
• Aggiornare i file influisce solo sugli acquisti futuri. Sostituzioni o rimozioni di file non alterano retroattivamente i download già emessi. I clienti precedenti possono comunque recuperare la versione che era valida quando la loro concessione è stata creata.
• I rimborsi non invalidano le copie scaricate. Un cliente che ha già scaricato un file mantiene quella copia. Per contenuti revocabili (media con licenze, accesso limitato nel tempo), abbina File Digitali con Chiavi di Licenza e valida a runtime.
• Per contenuti sensibili, preferisci URL esterni con la propria autenticazione. Gli URL presigned di Dodo Payments sono a breve durata ma non autenticati all’interno del loro intervallo; chiunque abbia l’URL può scaricare in quel lasso di tempo. Contenuti ospitati esternamente e protetti da account offrono garanzie più forti.

​

Gestione API

​

Webhook

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

​

Consegna di Prodotti Digitali Legacy

​

Buone Pratiche

• Tratta i download come operazioni una tantum. I clienti condivideranno o perderanno i link, quindi progetta il tuo prodotto assumendo che ciò che scaricano sia loro da conservare.
• Usa le istruzioni per impostare aspettative. Per pacchetti multi-file, aggiungi una riga instructions che spieghi cosa installare per primo o come combinare i file.
• Controlla il limite di 500 MiB. Gli oggetti più grandi (dataset multi-GB, corsi video) dovrebbero essere ospitati esternamente e collegati tramite external_url invece di essere caricati.
• Combina con chiavi di licenza per accesso revocabile. Se è necessario revocare l’accesso a funzionalità del prodotto dopo un rimborso, associa il diritto ai file digitali con un diritto alla chiave di licenza e convalida la chiave in fase di esecuzione.
• Testa il flusso di aggiornamento del portale clienti. Conferma che un cliente possa tornare al portale una settimana dopo e ottenere ancora un link di download funzionante. Questo è il percorso di recupero principale quando i link email scadono.