Zum Hauptinhalt springen

Documentation Index

Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Overview

Die digitale Produktauslieferung ist der Berechtigungstyp Digitale Dateien. Sie laden Ihre Dateien einmal in eine Berechtigung für digitale Dateien hoch, fügen die Berechtigung einem Produkt hinzu, und Dodo Payments liefert vorgenerierte Download-Links an jeden zahlenden Kunden per E-Mail und im Kundenportal. Die Berechtigung unterstützt:
  • Gehostete Datei-Uploads: Speichern Sie Dateien bei Dodo Payments und bereitstellen über kurzlebige vorgenerierte URLs.
  • Externe Download-Links: Verlinken Sie zu Dateien, die auf Dropbox, Google Drive, S3 oder einer beliebigen URL gehostet werden.
  • Download-Anweisungen: Freiform-Text, der dem Kunden auf seiner Bestellseite und in der Liefer-E-Mail angezeigt wird.
Sie können alle drei auf einer einzigen Berechtigung kombinieren.

​
Hauptmerkmale

File Upload

Dateien (PDF, ZIP, Bilder, Videos, etc.) bis zu 100 MB hochladen. Dateien werden effizient gestreamt und gespeichert.

Multiple Files

Fügen Sie einer einzigen Berechtigung so viele Dateien hinzu, wie Sie benötigen.

External Links

Stellen Sie externe Download-Links (Dropbox, Google Drive, signierte S3-URLs) als Alternative oder Ergänzung bereit.

Presigned URLs

Gehostete Dateien werden über kurzlebige vorgenerierte URLs bereitgestellt. Jede Download-URL läuft automatisch nach etwa 15 Minuten ab.

​
Digitale Produktauslieferung einrichten

1

Open Entitlements

Gehen Sie zu Berechtigungen in Ihrem Dodo Payments-Dashboard und klicken Sie auf +, um eine neue Berechtigung zu erstellen.
2

Choose Digital Files

Wählen Sie Digitale Produktauslieferung als Integration aus.
3

Add files, links, and instructions

Konfigurieren Sie jede Kombination von:
  • Dateien: Laden Sie eine oder mehrere Dateien hoch. Jeder Upload gibt einen file_id zurück, der der Berechtigung hinzugefügt wird.
  • Externe URL: Ein öffentlich erreichbarer HTTPS-Link, der zusammen mit gehosteten Dateien bereitgestellt wird.
  • Anweisungen: Freiform-Text, der dem Kunden angezeigt wird (z.B. “Entpacken und setup.sh ausführen”).
Berechtigung für digitale Dateien mit Dateiupload, externer URL und Anweisungsfeldern
4

Save the entitlement

Speichern. Die Berechtigung kann jetzt jedem Produkt hinzugefügt werden.

​
An Produkte anhängen

Öffnen Sie ein Produkt, erweitern Sie Erweiterte Einstellungen → Berechtigungen & Gutschriften, und wählen Sie Ihre Berechtigung für digitale Dateien. Die Berechtigung wird bei jedem erfolgreichen Kauf oder aktiven Abonnement, das mit diesem Produkt verknüpft ist, geliefert.
Produktberechtigungen-Panel mit aktivierter digitaler Produktauslieferung

​
Funktionsweise der Auslieferung

Die Auslieferung von digitalen Dateien folgt dem Standard Lebenszyklus der Erteilung:
EreignisVerhalten
payment.succeeded (einmalig)Erteilen Sie eine Erlaubnis. Die Erlaubnis enthält vorgenerierte Download-URLs, die ca. 15 Minuten gültig sind; Kunden können sie durch erneutes Öffnen des E-Mail-Links oder der Kundenportal-Seite aktualisieren.
subscription.activeErteilen Sie eine Erlaubnis. Dateien bleiben zugänglich, solange das Abonnement aktiv ist.
subscription.renewedKeine Operation. Die gleiche Erlaubnis bleibt bestehen; neue vorgenerierte URLs werden bei jedem Abruf erstellt.
subscription.on_hold / cancelled / expiredWiderrufen Sie die Erlaubnis. Neue vorgenerierte URLs werden nicht mehr ausgegeben.
subscription.plan_changedWiderrufen Sie die alte Erlaubnis; erteilen Sie eine neue für die Berechtigung des neuen Plans.
refund.succeeded (einmalig)Widerrufen Sie die Erlaubnis.
Manuelles WiderrufenWiderrufen Sie mit revocation_reason: manual.
Der Widerruf stoppt Dodo Payments daran, neue Download-URLs auszugeben, aber er macht nicht Kopien ungültig, die ein Kunde bereits heruntergeladen hat. Behandeln Sie Downloads gehosteter Dateien als “einmal gelesen, dann geliefert”.

​
Kundenerfahrung

​
Kaufbestätigung

Nach einer erfolgreichen Transaktion erhält der Kunde eine E-Mail mit Download-Links und allen von Ihnen konfigurierten Anweisungen.
Kaufbestätigungs-E-Mail mit Download-Links für digitale Produkte

​
Kundenportal-Zugang

Kunden können jederzeit die Download-Links aus dem Kundenportal abrufen. Die Portalseite generiert bei Bedarf neue vorgenerierte URLs, sodass derselbe Kauf auch dann funktioniert, wenn die Links in der E-Mail abgelaufen sind.
Kundenportal-Interface mit verfügbaren digitalen Produkten zum Download
Kunden können Dateien direkt aus Bestätigungs-E-Mails herunterladen oder jederzeit über ihr Portal darauf zugreifen.

​
Dateien programmgesteuert verwalten

​
Eine Datei zu einer Berechtigung hochladen

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',
});

​
Erlaubnisse 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 einer Berechtigung entfernen

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

​
Wichtige Überlegungen

  • Vorgenerierte URLs laufen schnell ab. Download-URLs, die in Erlaubnis-Nutzlasten oder Webhook-Ereignissen zurückgegeben werden, sind ca. 15 Minuten gültig. Speichern Sie sie nicht; rufen Sie sie neu ab, wenn der Kunde erneut herunterladen muss.
  • Dateiaktualisierungen betreffen nur zukünftige Käufe. Das Ersetzen oder Entfernen einer Datei ändert nicht rückwirkend Downloads, die bereits ausgegeben wurden. Frühere Kunden können weiterhin die Version abrufen, die aktuell war, als ihre Erlaubnis erstellt wurde.
  • Rückerstattungen machen heruntergeladene Kopien nicht ungültig. Ein Kunde, der bereits eine Datei heruntergeladen hat, behält diese Kopie. Für widerrufbare Inhalte (lizenzbeschränkte Medien, zeitlich begrenzter Zugriff) kombinieren Sie digitale Dateien mit Lizenzschlüsseln und validieren Sie zur Laufzeit.
  • Für sensible Inhalte bevorzugen Sie externe URLs mit eigener Auth. Vorgenerierte URLs von Dodo Payments laufen zwar kurzlebig ab, sind aber innerhalb ihres Fensters nicht authentifiziert; jeder mit der URL kann in diesem Fenster herunterladen. Extern gehostete, kontogeschützte Inhalte bieten stärkere Garantien.

​
API-Verwaltung

Create Entitlement

Erstellen Sie eine Berechtigung für digitale Dateien mit optionalen externen URL und Anweisungen.

Upload File

Laden Sie eine Datei (bis zu 100 MB) hoch und fügen Sie sie der Berechtigung hinzu.

Delete File

Entfernen Sie eine Datei aus der Berechtigung.

List Grants

Erlaubnisse auflisten und die aufgelösten Download-URLs lesen.

Update Entitlement

Aktualisieren Sie Anweisungen, externe URL oder ersetzen Sie Dateien.

Revoke Grant

Entziehen Sie manuell den Zugriff eines Kunden.

​
Webhooks

Digitale Dateiauslieferung und Widerruf lösen die vier entitlement_grant.* Webhook-Ereignisse aus. Für Erlaubnisse für digitale Dateien enthält die Nutzlast ein digital_product_delivery Objekt mit der aufgelösten Dateiliste (vorgenerierte URLs, Dateinamen, Größen), dem optionalen instructions und dem optionalen external_url. 
"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
}

​
Legacy digitale Produktauslieferung

Produkte, die mit dem älteren digital_product_delivery Block am Produkt selbst konfiguriert sind, wurden automatisch migriert zu einer Berechtigung für digitale Dateien. Vorhandene Dateien, die unter der Legacy-Produktdatei-API hochgeladen wurden, bleiben erhalten; sie sind weiterhin herunterladbar und erscheinen in Erlaubnis-Nutzlasten, die mit source: "legacy" gekennzeichnet sind. Zukünftige Updates (Hinzufügen von Dateien, Ändern von Anweisungen, Ersetzen der externen URL) sollten durch Bearbeiten der migrierten Berechtigung für digitale Dateien unter Berechtigungen vorgenommen werden.Die Legacy-Produktfeld-Level (digital_product_delivery.external_url, digital_product_delivery.instructions) werden weiterhin für Rückwärtskompatibilität in Produktantworten gefüllt, aber die Berechtigung ist die maßgebliche Quelle für die Zukunft.

​
Beste Praktiken

  • Behandeln Sie Downloads als einmalig. Kunden werden Links teilen oder verlieren, daher sollten Sie Ihr Produkt so gestalten, dass alles, was sie herunterladen, ihnen gehört.
  • Verwenden Sie Anweisungen, um Erwartungen zu setzen. Fügen Sie für Bündel mit mehreren Dateien eine instructions-Zeile hinzu, die erklärt, was zuerst installiert oder wie die Dateien kombiniert werden sollen.
  • Achten Sie auf das 100-MB-Limit. Größere Artefakte (mehrere GB-Datensätze, Videokurse) sollten extern gehostet und über external_url verlinkt anstatt hochgeladen werden.
  • Kombinieren Sie mit Lizenzschlüsseln für widerrufbaren Zugriff. Wenn Sie den Zugang zu In-Produkt-Features nach einer Rückerstattung widerrufen müssen, kombinieren Sie die Berechtigung für digitale Dateien mit einer Lizenzschlüssel-Berechtigung und validieren Sie den Schlüssel zur Laufzeit.
  • Testen Sie den Kundenportal-Refresh-Flow. Stellen Sie sicher, dass ein Kunde eine Woche später zum Portal zurückkehren und weiterhin einen gültigen Download-Link erhalten kann. Dies ist der primäre Wiederherstellungspfad, wenn Links in der E-Mail abgelaufen sind.
Last modified on May 14, 2026