استحقاق 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 من Notion ليتمكن العميل من ربط مساحة عمله.
3. يفوّض العميل الوصول عبر الرابط الموجود في بريده الإلكتروني أو بوابة العميل، ويختار مساحة العمل التي يريد نسخ القالب إليها.
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 معرّف oauth_url الخاص بـ Notion.
• يتم تشغيل entitlement_grant.delivered بعد نسخ القالب.
• يتم تشغيل entitlement_grant.revoked عند الإلغاء؛ وتبقى نسخة العميل دون تغيير.

​

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