استحقاق Notion

​

ما يتم تسليمه

• يُطلب من العميل ربط مساحة عمل Notion الخاصة به عبر OAuth.
• بعد التفويض، ينسخ Dodo Payments القالب المُعدّ إلى مساحة العمل التي اختارها العميل.
• عند الإلغاء، يبقى القالب المنسوخ في مساحة عمل العميل (لا يدعم Notion الحذف عن بُعد). ويتم وضع علامة على التفويض بالحالة Revoked لأغراض حفظ السجلات.

​

ربط Notion

1

Open Entitlements

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

2

Pick Notion

اختر قالب Notion باعتباره التكامل. إذا لم يكن Notion متصلًا بعد، فسيُطلب منك ربط Notion.

يؤدي النقر للمتابعة إلى فتح Notion في علامة تبويب جديدة. سجّل الدخول إلى مساحة العمل التي تملك قوالبك المصدرية، وراجِع الأذونات التي يطلبها Dodo Payments، ثم اختر الصفحات (القوالب) التي يُسمح للتكامل بقراءتها ونسخها.

عند إعادة توجيهك من Notion، سترى تأكيدًا يفيد بربط مساحة العمل.

3

Pick a template

ارجع إلى لوحة المعلومات، وحدد القالب المراد نسخه من منتقي القوالب. لا تظهر هنا إلا الصفحات التي فوّضت الوصول إليها في الخطوة السابقة. امنح الاستحقاق اسمًا وانقر على إنشاء الاستحقاق.

4

Save the entitlement

احفظه وأرفقه بأي منتج.

​

تدفق العميل

1. يُكمل العميل عملية الدفع.
2. ينشئ Dodo Payments منحة بالحالة Pending. وتكون قيمة oauth_url فيها هي null إلى أن يبدأ العميل تدفق القبول، وعندها تتم تعبئتها بعنوان URL للتفويض في Notion.
3. يفوّض العميل عبر الرابط الموجود في بريده الإلكتروني أو Customer Portal، ويختار مساحة العمل التي يريد تكرار القالب فيها.
4. يكرّر Dodo Payments القالب. وتنتقل المنحة إلى Delivered.
5. عند الإلغاء، تُعلَّم المنحة بالحالة Revoked؛ وتبقى النسخة المكررة في مساحة عمل العميل.

​

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

​

الإنشاء عبر API

const entitlement = await client.entitlements.create({
  name: 'Study Notes',
  integration_type: 'notion',
  integration_config: {
    notion_template_id: 'tmpl_abc123',
  },
});

client.entitlements.create(
    name="Study Notes",
    integration_type="notion",
    integration_config={"notion_template_id": "tmpl_abc123"},
)

client.Entitlements.New(ctx, dodopayments.EntitlementNewParams{
  Name:            dodopayments.F("Study Notes"),
  IntegrationType: dodopayments.F(dodopayments.EntitlementIntegrationTypeNotion),
  IntegrationConfig: dodopayments.F[dodopayments.IntegrationConfigUnionParam](
    dodopayments.IntegrationConfigNotionConfigParam{
      NotionTemplateID: dodopayments.F("tmpl_abc123"),
    },
  ),
})

​

Webhooks

• يتم تشغيل entitlement_grant.created مع status: "Pending"، بينما تظل قيمة oauth_url هي null؛ ويتم تعبئة عنوان URL للتفويض في Notion بمجرد أن يبدأ العميل تدفق القبول من رسالة التسليم الإلكترونية أو Customer Portal.
• يتم تشغيل entitlement_grant.delivered بمجرد تكرار القالب.
• يتم تشغيل entitlement_grant.revoked عند الإلغاء؛ وتبقى نسخة العميل دون تغيير.

​

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