Notion 权益

Notion 权益会将你准备的模板复制到付费客户的 Notion 工作区。客户通过 Notion 授权 Dodo Payments，并选择接收模板的工作区，然后由 Dodo Payments 创建副本。

交付内容

客户从 Customer Portal 连接其 Notion 工作区。付款确认电子邮件会将该权益标记为 Action Required，并提供指向门户的链接。
完成授权后，Dodo Payments 会将配置的模板复制到客户在授权期间共享的页面中，该页面位于客户选择的工作区内。
撤销授权后，副本仍会保留在客户的工作区中。Dodo Payments 会将授权标记为 Revoked 以供记录，并且不会删除副本。

常见用途包括付费 Notion 模板、生产力系统，以及 OS 或 CRM 模板。

连接 Notion

Open Entitlements

在 Dodo Payments 控制面板中，前往 Entitlements，然后点击 +。

Pick Notion

选择 Notion Template 作为集成。如果尚未连接 Notion，请点击 Connect Notion。

New entitlement panel prompting the merchant to connect Notion — Connect Notion prompt before the OAuth handoff.

Notion 会在新标签页中打开。登录拥有源模板的工作区，并查看 Dodo Payments 请求的权限。然后选择集成可以读取和复制的页面（模板）。

Dodo Payments 的 Notion OAuth 权限页面 — Notion OAuth: review the permissions Dodo Payments requests.

选择 Dodo Payments 可访问模板的 Notion 页面选择器 — Notion OAuth: pick the template pages to share.

Notion 重定向回来后，确认页面会显示工作区已连接。

Notion Template 已成功连接的确认页面 — Workspace connected. Return to the Dodo Payments dashboard to continue.

Pick a Template

返回控制面板后，在 Template 下选择要复制的模板。此处仅会显示你在上一步共享的页面。为权益输入 Name，然后点击 Create Entitlement。

Attach It to a Product

将权益关联到任意产品。请参阅将权益关联到产品。

客户流程

客户完成结账。
Dodo Payments 创建一个处于 Pending 状态的授权记录。Dodo Payments 会立即尝试创建 Notion 授权 URL，并将其存储在 oauth_url 中。如果失败，oauth_url 会保持为 null，直到客户开始接受流程。
在 Customer Portal 中，客户点击权益上的 Connect，通过 Notion 授权，选择接收模板的工作区，并至少与 Dodo Payments 共享一个页面。
Dodo Payments 将模板复制到该工作区中的共享页面。授权记录变为 Delivered。
撤销授权后，授权记录会标记为 Revoked，副本仍保留在客户的工作区中。

撤销不会删除副本。副本位于客户的工作区中，Dodo Payments 的撤销流程只会将授权标记为 Revoked。

必需配置

字段	必需	描述
`notion_template_id`	是	要复制的模板 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: '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.* webhook 事件涵盖 Notion 流程：

entitlement_grant.created 会以 status: "Pending" 触发。oauth_url 可能已经包含 Notion 授权 URL。如果其值为 null，则会在客户从 Customer Portal 开始接受流程后填充。
模板复制完成后，entitlement_grant.delivered 会触发。
取消时，entitlement_grant.revoked 会触发。客户的副本不会受到影响。

故障排除

Customer didn't get the template

在客户完成 Notion 授权之前，授权会保持 Pending 状态。请让客户打开 Customer Portal 并点击 Connect。每个授权链接会在生成 30 分钟后过期，客户返回时，Customer Portal 会生成新的授权链接。在授权期间，客户必须至少共享一个页面，因为 Dodo Payments 会在共享页面内创建副本。

Template picker is empty

在权益表单中，点击 Notion 卡片上的 Disconnect，然后点击 Connect Notion，使用拥有源模板的工作区重新连接。在授权期间共享模板页面。

Customer wants the template removed after refund

Dodo Payments 撤销授权时不会删除副本。客户必须从自己的工作区中删除副本。

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

交付内容

连接 Notion

客户流程

必需配置

通过 API 创建

Webhooks

故障排除

​交付内容

​连接 Notion

​客户流程

​必需配置

​通过 API 创建

​Webhooks

​故障排除

交付内容

连接 Notion

客户流程

必需配置

通过 API 创建

Webhooks

故障排除