استحقاق Notion

ما يتم تسليمه

• يربط العميل مساحة عمل Notion الخاصة به من Customer Portal. تحدد رسالة تأكيد الدفع أن الصلاحية مطلوب إجراء وتوفر رابطًا إلى البوابة.
• بعد التفويض، ينسخ Dodo Payments القالب المُعد إلى صفحة شاركها العميل أثناء التفويض، ضمن مساحة العمل التي اختارها.
• عند إلغاء الصلاحية، تبقى النسخة في مساحة عمل العميل. يضع Dodo Payments علامة Revoked على المنحة لأغراض حفظ السجلات ولا يحذف النسخة.

ربط Notion

1

Open Entitlements

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

2

Pick Notion

اختر Notion Template باعتباره التكامل. إذا لم يكن Notion متصلًا بعد، فانقر على Connect Notion.

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

عندما يعيد Notion التوجيه، تعرض صفحة تأكيد أن مساحة العمل متصلة.

3

Pick a Template

بالعودة إلى لوحة التحكم، حدد القالب المراد نسخه ضمن Template. تظهر هنا فقط الصفحات التي شاركتها في الخطوة السابقة. أدخل Name للصلاحية وانقر على Create Entitlement.

4

Attach It to a Product

أرفق الصلاحية بأي منتج. راجع إرفاق الصلاحيات بالمنتجات.

تدفق العميل

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

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

الإنشاء عبر 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: 'Study Notes',
  integration_type: 'notion',
  integration_config: {
    notion_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="Study Notes",
    integration_type="notion",
    integration_config={"notion_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("Study Notes"),
  IntegrationType: dodopayments.F(dodopayments.EntitlementIntegrationTypeNotion),
  IntegrationConfig: dodopayments.F[dodopayments.IntegrationConfigUnionParam](
    dodopayments.IntegrationConfigNotionConfigParam{
      NotionTemplateID: dodopayments.F("3f2b8c1e-7d4a-4e9b-a6c5-1d2e3f4a5b6c"),
    },
  ),
})

Webhooks

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

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