Framer Entitlement

يمنح entitlement الخاص بـ Framer العملاء الذين أتموا الدفع رابط remix لقالب Framer. تسجّل رابط remix للقالب في Dodo Payments وتربط entitlement بمنتج. يحصل العملاء على الرابط في Customer Portal ويستخدمونه لنسخ القالب إلى حساب Framer الخاص بهم.

ما يتم تسليمه

رابط remix لقالب Framer الذي سجلته. يحصل كل عميل يشتري المنتج على الرابط نفسه.
يفتح العميل الرابط من Customer Portal وينسخ القالب إلى مساحة عمل Framer الخاصة به.
عند الإلغاء أو استرداد المبلغ، يتوقف Customer Portal عن عرض الرابط. يظل الرابط نفسه يعمل في Framer، لذلك يمكن لأي شخص حفظه أن يواصل نسخ القالب.

تشمل الاستخدامات الشائعة قوالب صفحة الهبوط المدفوعة على Framer، مجموعات البورتفوليو، ومكتبات المكونات.

توصيل Framer

يتم توصيل Framer ضمنيًا في المرة الأولى التي تقوم فيها بإنشاء امتياز للقالب. لا توجد خطوة OAuth منفصلة.

Open Entitlements

في لوحة تحكم Dodo Payments، انتقل إلى Entitlements وانقر على +.

Pick Framer

اختر Framer Template كتكامل.

Grab the Remix Link from Framer

افتح مشروع Framer الخاص بك. من القائمة العلوية اليسرى، انتقل إلى File → Copy Remix Link. يؤدي ذلك إلى نسخ عنوان URL عام لـ remix يتيح لأي شخص استنساخ المشروع إلى حساب Framer الخاص به. يشارك Dodo Payments هذا الرابط مع العملاء الذين أتموا الدفع.

Framer File menu with Copy Remix Link option highlighted — Framer File menu: click Copy Remix Link to copy the template's remix URL.

Add the Template and Create the Entitlement

بالعودة إلى لوحة تحكم Dodo Payments، حدّد القالب ضمن Template. لتسجيل قالب جديد، انقر على + Create new template، وأدخل Template name، والصق الرابط الذي نسخته في Remix link (يجب أن يكون عنوان URL من نوع framer.com)، ثم انقر على Create template. أدخل Name لـ entitlement وانقر على Create Entitlement.

Framer template entitlement form with template picker and name field

يخزّن Dodo Payments معرّف القالب المسجّل باعتباره framer_template_id في integration_config الخاص بـ entitlement، حتى تتمكن من الرجوع إليه برمجيًا.

تدفق العميل

يُكمل العميل عملية الدفع.
ينشئ Dodo Payments كائن grant من النوع Pending ويربط به رابط remix الخاص بالقالب.
ينتقل grant إلى الحالة Delivered بمجرد إرفاق رابط remix به. يحتوي بريد تأكيد الدفع الإلكتروني على رابط إلى Customer Portal، حيث يجد العميل الرابط ضمن entitlement.
يفتح العميل الرابط، ويسجّل الدخول إلى Framer، وينسخ القالب.
عند الإلغاء، يتوقف Customer Portal عن عرض الرابط. تبقى النسخ التي تم نسخها مسبقًا إلى حساب Framer الخاص بالعميل، لأن Framer لا يوفّر طريقة لإلغائها.

الإعداد المطلوب

الحقل	مطلوب	الوصف
`framer_template_id`	نعم	معرّف القالب (وهو UUID) الذي سجلته في لوحة التحكم.

الإنشاء عبر API

import DodoPayments from 'dodopayments';

const client = new DodoPayments({
  bearerToken: process.env['DODO_PAYMENTS_API_KEY'],
  environment: 'test_mode',
});

const entitlement = await client.entitlements.create({
  name: 'Portfolio Kit',
  integration_type: 'framer',
  integration_config: {
    framer_template_id: '3f2b8c1e-7d4a-4e9b-a6c5-1d2e3f4a5b6c',
  },
});

import os
from dodopayments import DodoPayments

client = DodoPayments(bearer_token=os.environ.get("DODO_PAYMENTS_API_KEY"), environment="test_mode")

entitlement = client.entitlements.create(
    name="Portfolio Kit",
    integration_type="framer",
    integration_config={"framer_template_id": "3f2b8c1e-7d4a-4e9b-a6c5-1d2e3f4a5b6c"},
)

// client is a *dodopayments.Client, for example from
// dodopayments.NewClient(option.WithEnvironmentTestMode()); ctx is a context.Context.
client.Entitlements.New(ctx, dodopayments.EntitlementNewParams{
  Name:            dodopayments.F("Portfolio Kit"),
  IntegrationType: dodopayments.F(dodopayments.EntitlementIntegrationTypeFramer),
  IntegrationConfig: dodopayments.F[dodopayments.IntegrationConfigUnionParam](
    dodopayments.IntegrationConfigFramerConfigParam{
      FramerTemplateID: dodopayments.F("3f2b8c1e-7d4a-4e9b-a6c5-1d2e3f4a5b6c"),
    },
  ),
})

Webhooks

اطّلع على أحداث webhook من نوع entitlement_grant.*. تصل منح Framer في الحالة Pending وتنتقل إلى الحالة Delivered بمجرد إرفاق رابط remix بالـ grant.

استكشاف الأخطاء وإصلاحها

Customer's remix link doesn't work

رابط remix ليس للاستخدام مرة واحدة ولا يرتبط بعميل واحد. يحصل كل عميل على الرابط الذي سجلته، ويمكنه فتحه مرة أخرى من Customer Portal ما دام grant في الحالة Delivered. إذا لم يعمل الرابط، افتحه بنفسك للتأكد من أن رابط remix لا يزال صالحًا في Framer.

Refunded customer still has a remixed copy

هذا متوقع. يتعامل Framer مع remix باعتباره مشروع العميل الخاص بمجرد استنساخه. يتوقف Dodo Payments عن عرض الرابط في Customer Portal، لكنه لا يستطيع حذف النسخ من حساب العميل، ولا يستطيع تعطيل رابط remix نفسه.

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

ما يتم تسليمه

توصيل Framer

تدفق العميل

الإعداد المطلوب

الإنشاء عبر API

Webhooks

استكشاف الأخطاء وإصلاحها