Entrega de Productos Digitales

​

Descripción General

• Hosted file uploads: Dodo Payments almacena tus archivos y los sirve mediante URLs presigned de corta duración.
• External download link: una URL por entitlement que apunta a archivos alojados en otro lugar, como Dropbox, Google Drive o S3.
• Download instructions: texto libre que se muestra al cliente en la página de su pedido y en el correo electrónico de entrega.

​

Características Clave

​

Configurar Digital Product Delivery

1

Open Entitlements

Ve a Entitlements en el dashboard y haz clic en + para crear un entitlement.

2

Choose Digital Files

Selecciona Digital Files e introduce un Name para el entitlement.

3

Add Files, Links, and Instructions

Configura cualquier combinación de estos campos:

• Upload files: sube uno o más archivos. Cada carga devuelve un file_id y añade el archivo al digital_file_ids del entitlement.
• External Download Link: una URL que comienza con http:// o https:// y a la que los clientes pueden acceder. Dodo Payments la entrega junto con los archivos alojados.
• Instructions: texto libre que se muestra al cliente, por ejemplo, “Descomprime y ejecuta setup.sh.”

4

Save the Entitlement

Haz clic en Create Entitlement. Ahora puedes vincular el entitlement a cualquier producto.

​

Adjuntar a Productos

​

Cómo Funciona la Entrega

​

Experiencia del Cliente

​

Confirmación de Compra

​

Acceso del Portal del Cliente

​

Gestión de Archivos Programáticamente

​

Subir un archivo a 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"

​

Enumerar grants y resolver URLs de descarga

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

​

Eliminar un archivo de un entitlement

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

​

Consideraciones importantes

• Las URLs presigned caducan rápidamente. Las URLs de descarga en los payloads de grant y los eventos de webhook son válidas durante 15 minutos. No las almacenes. Obtén URLs nuevas cuando el cliente necesite descargar el archivo de nuevo.
• La actualización de archivos solo afecta a compras futuras. Sustituir o eliminar un archivo no cambia las descargas ya emitidas. Cada grant conserva la configuración del entitlement que existía cuando se creó, por lo que los clientes anteriores aún pueden obtener la versión que estaba vigente en ese momento.
• Los reembolsos no invalidan las copias descargadas. Un cliente que ya haya descargado un archivo conserva esa copia. Para contenido revocable, como medios con restricciones de licencia o acceso limitado en el tiempo, combina Digital Files con License Keys y valida la clave en runtime.
• Para contenido sensible, es preferible usar URLs externas con su propia autenticación. Las URLs presigned de Dodo Payments tienen una duración corta, pero cualquiera que tenga la URL puede descargar el archivo hasta que caduque. El contenido alojado externamente y protegido mediante inicio de sesión en una cuenta te proporciona más control.

​

Gestión de 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
}

​

Digital Product Delivery heredado

​

Prácticas recomendadas

• Trata las descargas como entregas únicas. Los clientes pueden compartir o perder los enlaces, así que diseña tu producto suponiendo que todo lo que descarguen será suyo para conservarlo.
• Usa las instrucciones para establecer expectativas. Para paquetes con varios archivos, añade una línea instructions que explique qué instalar primero o cómo combinar los archivos.
• Ten en cuenta el límite de 500 MiB. Aloja externamente los artefactos más grandes, como conjuntos de datos de varios GB o cursos de vídeo, y enlázalos con external_url en lugar de subirlos.
• Combínalo con License Keys para obtener acceso revocable. Para revocar el acceso a funciones dentro del producto después de un reembolso, combina el entitlement Digital Files con un entitlement License Key y valida la clave en runtime.
• Prueba el flujo de actualización del Customer Portal. Confirma que un cliente pueda volver al portal una semana después y seguir obteniendo un enlace de descarga funcional. El portal es la principal vía de recuperación cuando caducan los enlaces del correo electrónico.