Livraison de Produits Numériques

​

Aperçu

• Téléversements de fichiers hébergés : Dodo Payments stocke vos fichiers et les distribue via des URL presigned à durée de validité limitée.
• Lien de téléchargement externe : une URL par entitlement qui pointe vers des fichiers hébergés ailleurs, par exemple sur Dropbox, Google Drive ou S3.
• Instructions de téléchargement : texte libre affiché au client sur sa page de commande et dans l’e-mail de livraison.

​

Caractéristiques Clés

​

Configurer la livraison d’un produit numérique

1

Open Entitlements

Accédez à Entitlements dans le dashboard, puis cliquez sur + pour créer un entitlement.

2

Choose Digital Files

Sélectionnez Digital Files et saisissez un Name pour l’entitlement.

3

Add Files, Links, and Instructions

Configurez n’importe quelle combinaison de ces champs :

• Téléverser des fichiers : téléversez un ou plusieurs fichiers. Chaque téléversement renvoie un file_id et ajoute le fichier à l’digital_file_ids de l’entitlement.
• External Download Link : une URL commençant par http:// ou https://, accessible aux clients. Dodo Payments la distribue avec les fichiers hébergés.
• Instructions : texte libre affiché au client, par exemple “Décompressez l’archive et exécutez setup.sh.”

4

Save the Entitlement

Cliquez sur Create Entitlement. Vous pouvez maintenant associer l’entitlement à n’importe quel produit.

​

Attacher aux Produits

​

Comment la Livraison Fonctionne

​

Expérience Client

​

Confirmation d’Achat

​

Accès au Portail Client

​

Gérer les Fichiers Programmatiquement

​

Téléverser un fichier dans 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"

​

Lister les grants et résoudre les URL de téléchargement

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

​

Supprimer un fichier d’un entitlement

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

​

Points importants

• Les URL presigned expirent rapidement. Les URL de téléchargement contenues dans les payloads des grants et les événements webhook sont valides pendant 15 minutes. Ne les stockez pas. Récupérez de nouvelles URL lorsque le client doit télécharger à nouveau le fichier.
• La mise à jour des fichiers concerne uniquement les achats futurs. Le remplacement ou la suppression d’un fichier ne modifie pas les téléchargements déjà émis. Chaque grant conserve la configuration de l’entitlement au moment de sa création ; les anciens clients peuvent donc toujours obtenir la version qui était alors disponible.
• Les remboursements n’invalident pas les copies téléchargées. Un client qui a déjà téléchargé un fichier conserve cette copie. Pour les contenus révocables, tels que les médias soumis à des restrictions de licence ou les accès limités dans le temps, associez Digital Files à License Keys et validez la clé à l’exécution.
• Pour les contenus sensibles, préférez des URL externes avec leur propre authentification. Les URL presigned de Dodo Payments sont à durée de validité limitée, mais toute personne disposant de l’URL peut télécharger le fichier jusqu’à son expiration. Un contenu hébergé en externe et protégé par une connexion à un compte vous offre davantage de contrôle.

​

Gestion via l’API

​

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
}

​

Livraison de produits numériques héritée

​

Bonnes pratiques

• Considérez les téléchargements comme des livraisons uniques. Les clients peuvent partager ou perdre les liens ; concevez donc votre produit en partant du principe que tout ce qu’ils téléchargent leur appartient définitivement.
• Utilisez les instructions pour définir les attentes. Pour les bundles contenant plusieurs fichiers, ajoutez une ligne instructions expliquant quoi installer en premier ou comment combiner les fichiers.
• Tenez compte de la limite de 500 MiB. Hébergez ailleurs les artefacts plus volumineux, tels que les jeux de données de plusieurs Go ou les formations vidéo, et créez un lien vers eux avec external_url au lieu de les téléverser.
• Associez License Keys pour un accès révocable. Pour révoquer l’accès aux fonctionnalités intégrées au produit après un remboursement, associez l’entitlement Digital Files à un entitlement License Key et validez la clé à l’exécution.
• Testez le flux d’actualisation du Customer Portal. Vérifiez qu’un client peut revenir sur le portail une semaine plus tard et obtenir malgré tout un lien de téléchargement fonctionnel. Le portail est le principal moyen de récupération lorsque les liens d’e-mail expirent.