Notion エンタイトルメント

​

納品内容

• 顧客は OAuth を介して Notion のワークスペースを接続するよう求められます。
• 認証が完了すると、Dodo Payments は設定済みのテンプレートを顧客が選択したワークスペースに複製します。
• キャンセルした場合も、複製されたテンプレートは顧客のワークスペースに残ります（Notion はリモート削除をサポートしていません）。記録保持のため、grant は 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 ステータスの grant を作成します。その oauth_url は、顧客が accept flow を開始するまで null です。開始すると、Notion authorization URL が設定されます。
3. 顧客がメールまたは顧客ポータルのリンクから承認し、テンプレートを複製する workspace を選択します。
4. Dodo Payments がテンプレートを複製します。grant は Delivered に移行します。
5. 取り消し時に grant は Revoked としてマークされます。複製されたコピーは顧客の workspace に残ります。

​

必要な設定

​

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 の状態で発生します。顧客が配信メールまたは顧客ポータルから accept flow を開始すると、Notion authorization URL が設定されます。
• テンプレートが複製されると、entitlement_grant.delivered が発生します。
• キャンセル時に entitlement_grant.revoked が発生します。顧客のコピーには変更が加えられません。

​

トラブルシューティング