توصيل المنتجات الرقمية

​

نظرة عامة

• Hosted file uploads: يخزّن Dodo Payments ملفاتك ويقدّمها عبر عناوين URL موقّعة مسبقًا قصيرة الأجل.
• External download link: عنوان URL واحد لكل استحقاق يشير إلى ملفات مستضافة في مكان آخر، مثل Dropbox أو Google Drive أو S3.
• Download instructions: نص حر يظهر للعميل في صفحة الطلب وفي رسالة التسليم الإلكترونية.

​

الميزات الرئيسية

​

إعداد تسليم المنتج الرقمي

1

Open Entitlements

انتقل إلى Entitlements في لوحة المعلومات وانقر على + لإنشاء استحقاق.

2

Choose Digital Files

حدّد Digital Files وأدخل Name للاستحقاق.

3

Add Files, Links, and Instructions

اضبط أي مجموعة من هذه الحقول:

• Upload files: حمّل ملفًا واحدًا أو أكثر. تُرجع كل عملية تحميل file_id وتضيف الملف إلى digital_file_ids الخاص بالاستحقاق.
• External Download Link: عنوان URL يبدأ بـ http:// أو https:// ويمكن للعملاء الوصول إليه. يسلّمه Dodo Payments إلى جانب الملفات المستضافة.
• Instructions: نص حر يظهر للعميل، مثل “فك الضغط وشغّل setup.sh.”

4

Save the Entitlement

انقر على Create Entitlement. يمكنك الآن إرفاق الاستحقاق بأي منتج.

​

الإرفاق بالمنتجات

​

آلية التسليم

​

تجربة العميل

​

تأكيد الشراء

​

الوصول عبر Customer Portal

​

إدارة الملفات برمجيًا

​

تحميل ملف إلى استحقاق

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"

​

إدراج المنح وحل عناوين URL للتنزيل

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

​

إزالة ملف من استحقاق

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

​

اعتبارات مهمة

• تنتهي صلاحية عناوين URL الموقّعة مسبقًا بسرعة. تكون عناوين URL للتنزيل في بيانات المنح وأحداث webhook صالحة لمدة 15 دقيقة. لا تخزّنها. اجلب عناوين URL جديدة عندما يحتاج العميل إلى التنزيل مرة أخرى.
• تؤثر تحديثات الملفات في عمليات الشراء المستقبلية فقط. لا يؤدي استبدال ملف أو إزالته إلى تغيير التنزيلات التي تم إصدارها بالفعل. تحتفظ كل منحة بإعدادات الاستحقاق عند إنشائها، لذلك لا يزال بإمكان العملاء السابقين الحصول على الإصدار الذي كان ساريًا حينها.
• لا تؤدي عمليات استرداد الأموال إلى إبطال النسخ التي تم تنزيلها. يحتفظ العميل الذي نزّل ملفًا بالفعل بنسخته. بالنسبة إلى المحتوى القابل للإلغاء، مثل الوسائط المقيّدة بترخيص أو الوصول المحدود زمنيًا، اقرن Digital Files بـ License Keys وتحقق من المفتاح أثناء التشغيل.
• بالنسبة إلى المحتوى الحساس، يُفضّل استخدام عناوين URL خارجية مع المصادقة الخاصة بها. تكون عناوين URL الموقّعة مسبقًا من Dodo Payments قصيرة الأجل، لكن يمكن لأي شخص يملك عنوان URL تنزيل الملف حتى تنتهي صلاحيته. يمنحك المحتوى المستضاف خارجيًا خلف تسجيل دخول إلى حساب تحكمًا أكبر.

​

إدارة 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
}

​

تسليم المنتج الرقمي القديم

​

أفضل الممارسات

• تعامل مع التنزيلات على أنها عمليات تسليم لمرة واحدة. يمكن للعملاء مشاركة الروابط أو فقدانها، لذا صمّم منتجك على افتراض أن أي شيء ينزّلونه يصبح ملكًا لهم للاحتفاظ به.
• استخدم التعليمات لتوضيح التوقعات. بالنسبة إلى الحزم متعددة الملفات، أضف سطر instructions يوضّح ما يجب تثبيته أولًا أو كيفية دمج الملفات.
• انتبه إلى الحد الأقصى البالغ 500 MiB. استضف العناصر الأكبر حجمًا، مثل مجموعات البيانات متعددة الجيجابايت أو دورات الفيديو، خارجيًا، واربطها باستخدام external_url بدلًا من تحميلها.
• اجمعه مع License Keys للوصول القابل للإلغاء. لإلغاء الوصول إلى الميزات داخل المنتج بعد استرداد الأموال، اقرن استحقاق Digital Files باستحقاق License Key وتحقق من المفتاح أثناء التشغيل.
• اختبر مسار التحديث في Customer Portal. تأكد من قدرة العميل على العودة إلى البوابة بعد أسبوع والاستمرار في الحصول على رابط تنزيل صالح. تُعدّ البوابة مسار الاسترداد الرئيسي عند انتهاء صلاحية روابط البريد الإلكتروني.