跳转到主要内容

Documentation Index

Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt

Use this file to discover all available pages before exploring further.

Notion 权益功能会将您准备好的模板复制到付费客户的 Notion 工作区。客户通过 OAuth 授权,选择要复制模板的工作区,Dodo Payments 处理复制。

交付内容

  • 提示客户通过 OAuth 连接他们的 Notion 工作区。
  • 授权后,Dodo Payments 将已配置的模板复制到他们选择的工作区。
  • 取消时,复制的模板仍会保留在客户的工作区(Notion 不支持远程删除)。授予标记为 revoked 以供记录保存。
常见用途包括付费 Notion 模板、生产力系统和操作系统/CRM 模板。

连接 Notion

1

Open Entitlements

在你的 Dodo Payments 仪表板中,进入 Entitlements 并点击 +
2

Pick Notion

选择 Notion Template 作为集成。如果 Notion 尚未连接,会提示你 Connect Notion
New entitlement panel prompting the merchant to connect Notion
点击后将在新标签页中打开 Notion。登录拥有源模板的工作区,审核 Dodo Payments 请求的权限,然后选择可以读取和复制的页面(模板)。
Notion OAuth permissions screen for Dodo PaymentsNotion page picker selecting which templates Dodo Payments can access
当 Notion 重定向回来时,你会看到工作区已连接的确认信息。
Notion Template connected successfully confirmation page
3

Pick a template

返回仪表板,从模板选择器中选择要复制的 template。只有在上一步中授权的页面会显示在这里。为权限赋予 name 并点击 Create Entitlement
Notion entitlement form with connected workspace, template picker, and name field
4

Save the entitlement

保存并附加到任何产品。

客户流程

  1. 客户完成结账。
  2. Dodo Payments 创建一个状态为 pending 的授予,带有一个让客户连接其工作区的 Notion oauth_url
  3. 客户通过其邮件或客户门户中的链接授权,并选择要复制模板的工作区。
  4. Dodo Payments 复制模板。授予移动到 delivered
  5. 撤销时,授予标记为 revoked;复制的副本保留在客户的工作区中。
Notion 有意将复制的页面视为收件人的内容。Dodo Payments 无法在撤销时删除副本。

必需的配置

FieldRequiredDescription
notion_template_idYesThe template ID. The dashboard picker fills this in.

通过 API 创建

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

Webhooks

查看 entitlement_grant.* webhook events
  • entitlement_grant.created 包含 Notion oauth_url
  • entitlement_grant.delivered 当模板被复制时触发。
  • entitlement_grant.revoked 在取消时触发;客户的副本保持不变。

故障排除

授予保持 pending,直到客户完成 Notion OAuth。重新发送交付电子邮件;OAuth 链接在一周后过期,之后您可以撤销并重新创建授予。
Entitlements → Integrations → Notion 重新连接 Notion 与拥有源模板的工作区。
Notion 不允许远程删除复制的页面。客户必须从他们自己的工作区删除副本。
Last modified on May 14, 2026