Digital Product Delivery

​

Overview

• Gehostete Datei-Uploads: Dodo Payments speichert deine Dateien und stellt sie über kurzlebige presigned URLs bereit.
• Externer Download-Link: eine URL pro Entitlement, die auf Dateien verweist, die an anderer Stelle gehostet werden, etwa bei Dropbox, Google Drive oder S3.
• Download-Anweisungen: Freitext, der dem Kunden auf seiner Bestellseite und in der E-Mail zur Bereitstellung angezeigt wird.

​

Hauptmerkmale

​

Digital Product Delivery einrichten

1

Open Entitlements

Gehe im Dashboard zu Entitlements und klicke auf +, um ein Entitlement zu erstellen.

2

Choose Digital Files

Wähle Digital Files aus und gib unter Name einen Namen für das Entitlement ein.

3

Add Files, Links, and Instructions

Konfiguriere eine beliebige Kombination dieser Felder:

• Dateien hochladen: Lade eine oder mehrere Dateien hoch. Jeder Upload gibt einen file_id zurück und fügt die Datei zur digital_file_ids des Entitlements hinzu.
• External Download Link: eine URL, die mit http:// oder https:// beginnt und die Kunden aufrufen können. Dodo Payments stellt sie zusammen mit den gehosteten Dateien bereit.
• Instructions: Freitext, der dem Kunden angezeigt wird, zum Beispiel “Unzip and run setup.sh.”

4

Save the Entitlement

Klicke auf Create Entitlement. Du kannst das Entitlement jetzt mit jedem Produkt verknüpfen.

​

An Produkte anhängen

​

Funktionsweise der Auslieferung

​

Kundenerfahrung

​

Kaufbestätigung

​

Kundenportal-Zugang

​

Dateien programmgesteuert verwalten

​

Eine Datei zu einem Entitlement hochladen

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"

​

Grants auflisten und Download-URLs auflösen

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

​

Eine Datei aus einem Entitlement entfernen

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

​

Wichtige Hinweise

• Presigned URLs laufen schnell ab. Download-URLs in Grant-Payloads und Webhook-Ereignissen sind 15 Minuten gültig. Speichere sie nicht. Rufe neue URLs ab, wenn der Kunde erneut herunterladen möchte.
• Das Aktualisieren von Dateien betrifft nur zukünftige Käufe. Das Ersetzen oder Entfernen einer Datei ändert keine bereits ausgestellten Downloads. Jeder Grant enthält die Entitlement-Konfiguration zum Zeitpunkt seiner Erstellung, sodass frühere Kunden weiterhin die damals aktuelle Version erhalten können.
• Rückerstattungen machen heruntergeladene Kopien nicht ungültig. Ein Kunde, der eine Datei bereits heruntergeladen hat, behält diese Kopie. Für widerrufbare Inhalte, etwa lizenzbeschränkte Medien oder zeitlich begrenzten Zugriff, kombiniere Digital Files mit License Keys und validiere den Schlüssel zur Laufzeit.
• Für sensible Inhalte solltest du externe URLs mit eigener Authentifizierung bevorzugen. Presigned URLs von Dodo Payments sind kurzlebig, aber jeder mit der URL kann die Datei bis zu ihrem Ablauf herunterladen. Extern gehostete Inhalte hinter einem Konto-Login geben dir mehr Kontrolle.

​

API-Verwaltung

​

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
}

​

Legacy Digital Product Delivery

​

Best Practices

• Behandle Downloads als einmalige Bereitstellungen. Kunden können Links teilen oder verlieren. Entwickle dein Produkt daher unter der Annahme, dass alles, was sie herunterladen, in ihrem Besitz bleibt.
• Verwende Anweisungen, um Erwartungen festzulegen. Füge bei Bundles mit mehreren Dateien eine instructions-Zeile hinzu, die erklärt, was zuerst installiert werden muss oder wie die Dateien kombiniert werden.
• Beachte das Limit von 500 MiB. Hoste größere Artefakte wie Datensätze mit mehreren GB oder Videokurse extern und verknüpfe sie mit external_url, statt sie hochzuladen.
• Kombiniere den Zugriff mit License Keys, wenn er widerrufbar sein soll. Um den Zugriff auf Produktfunktionen nach einer Rückerstattung zu widerrufen, kombiniere das Digital-Files-Entitlement mit einem License-Key-Entitlement und validiere den Schlüssel zur Laufzeit.
• Teste den Aktualisierungsablauf im Customer Portal. Stelle sicher, dass ein Kunde eine Woche später zum Portal zurückkehren und weiterhin einen funktionierenden Download-Link erhalten kann. Das Portal ist der wichtigste Wiederherstellungsweg, wenn E-Mail-Links ablaufen.