Digital Product Delivery

​

Overview

• Värdbaserade filuppladdningar: Dodo Payments lagrar dina filer och tillhandahåller dem via kortlivade försignerade URL:er.
• Extern nedladdningslänk: en URL per behörighet som pekar på filer som finns någon annanstans, till exempel Dropbox, Google Drive eller S3.
• Nedladdningsinstruktioner: fritt formaterad text som visas för kunden på ordersidan och i leveransmeddelandet.

​

Key Features

​

Konfigurera leverans av digitala produkter

1

Open Entitlements

Gå till Entitlements i kontrollpanelen och klicka på + för att skapa en behörighet.

2

Choose Digital Files

Välj Digital Files och ange ett Name för behörigheten.

3

Add Files, Links, and Instructions

Konfigurera valfri kombination av dessa fält:

• Ladda upp filer: ladda upp en eller flera filer. Varje uppladdning returnerar en file_id och lägger till filen i behörighetens digital_file_ids.
• Extern nedladdningslänk: en URL som börjar med http:// eller https:// och som kunder kan nå. Dodo Payments levererar den tillsammans med de värdbaserade filerna.
• Instruktioner: fritt formaterad text som visas för kunden, till exempel “Packa upp och kör setup.sh.”

4

Save the Entitlement

Klicka på Create Entitlement. Du kan nu koppla behörigheten till valfri produkt.

​

Attach to Products

​

How Delivery Works

​

Customer Experience

​

Purchase Confirmation

​

Customer Portal Access

​

Manage Files Programmatically

​

Ladda upp en fil till en behörighet

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"

​

Lista beviljanden och lös nedladdnings-URL:er

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

​

Ta bort en fil från en behörighet

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

​

Viktiga överväganden

• Försignerade URL:er upphör snabbt att gälla. Nedladdnings-URL:er i beviljandenas payloads och webhook-händelser är giltiga i 15 minuter. Spara dem inte. Hämta nya URL:er när kunden behöver ladda ned igen.
• Uppdatering av filer påverkar endast framtida köp. Att ersätta eller ta bort en fil ändrar inte redan utfärdade nedladdningar. Varje beviljande behåller behörighetskonfigurationen från när det skapades, så tidigare kunder kan fortfarande få den version som var aktuell då.
• Återbetalningar ogiltigförklarar inte nedladdade kopior. En kund som redan har laddat ned en fil behåller den kopian. För innehåll som kan återkallas, till exempel licensbegränsade medier eller tidsbegränsad åtkomst, kombinerar du Digital Files med License Keys och validerar nyckeln vid körning.
• För känsligt innehåll bör du föredra externa URL:er med egen autentisering. Försignerade URL:er från Dodo Payments är kortlivade, men alla som har URL:en kan ladda ned filen tills den upphör att gälla. Externt värdbaserat innehåll bakom en kontoinloggning ger dig mer kontroll.

​

API-hantering

​

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
}

​

Äldre leverans av digitala produkter

​

Bästa praxis

• Betrakta nedladdningar som engångsleveranser. Kunder kan dela eller förlora länkar, så utforma produkten utifrån antagandet att allt de laddar ned är deras att behålla.
• Använd instruktioner för att tydliggöra förväntningarna. För paket med flera filer kan du lägga till en instructions-rad som förklarar vad som ska installeras först eller hur filerna ska kombineras.
• Håll koll på gränsen på 500 MiB. Värdplacera större artefakter, till exempel datauppsättningar på flera GB eller videokurser, externt och länka till dem med external_url i stället för att ladda upp dem.
• Kombinera med License Keys för åtkomst som kan återkallas. Om du vill återkalla åtkomsten till funktioner i produkten efter en återbetalning kombinerar du Digital Files-behörigheten med en License Key-behörighet och validerar nyckeln vid körning.
• Testa uppdateringsflödet i Customer Portal. Bekräfta att en kund kan återvända till portalen en vecka senare och fortfarande få en fungerande nedladdningslänk. Portalen är den huvudsakliga återställningsvägen när e-postlänkar upphör att gälla.